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Chapter 1 Introduction 


1.1 General Information 


The AdvaInform Object Handling package is an option for the Advant Station 500 Series 
Information Management Station (IMS). To use AdvaInform Object Handling, AdvaInform 
Basic Functions software must be installed. It is the minimum software required for 
AdvalInform software. 


This book describes the AdvaInform Object Handling for both Advant OCS with Master 
software and with MOD 300 software. There are some differences in Object Handling between 
Master and MOD 300. These are mainly related to differences in object types between the two 
systems. Wherever such differences occur in the book they will be marked with a parenthesis 
(Master) or (MOD 300). A detailed description of the differences is given in Section 1.3, How 
to Use This Book. 


Object Handling extends the object-oriented concept of Advant OCS into the AdvaInform level. 
An operator can just as easily enter a dialogue with a production optimization routine in Object 
Handling as with a PID or CCF loop. The same applies to the information client using 
AdvaInform Display. Looking at the Object Handling objects is just as easy as studying the 
current data of a process object. 


Object Handling opens the door to SCADA solutions where data from DCS systems, PLC 
systems and Advant Controllers can be stored for display on PC:s (AdvalInform Display) or on 
operator stations. Together, AdvaInform Display and Object Handling provide an excellent 
SCADA application platform. 


Object Handling makes applications for production planning, quality supervision and process 
optimization visible on the operator station, on AdvaInform Display and for SQL clients. 


Object Handling lets you configure, execute and monitor the applications’ status in the form of 
User Objects. It also includes a number of pre-defined Basic Objects which are essential parts of 
the option. The packaging of the basic objects is identical between Master and MOD 300 even if 
the usage may be limited for some combinations. 


° Master Process Object such as AI, AO - Analog Input/Output, DI,DO - Digital 
Input/Output, Text - Text Objects, DAT - general purpose data storage object, 4 data 
formats are included in both Master and MOD 300. 


° MOD 300 process objects DATA_FCM - general purpose data storage and 
VA_STRING_FCM - text object are included in MOD 300 IMS. 


These Basic Objects can be used for several purposes, such as: 
Local storage - distributed access and event and alarm handling 


You can store the results of various applications such as User API programs in Basic 
Objects. Thus, the results become public (visible, for example from an operator 
station or from Advalnform Display). You can log them in History logs. You can also 
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attach alarm limits to the results. The resulting events/alarms! 


distributed to operator stations. 


are automatically 


Using the AdvaCommand User Interface, your operators can interact with 
AdvalInform applications through the Basic Objects. For example by setting a Basic 
Object value using an AdvaCommand dialogue they can start down-loading a recipe 
to a Controller. 


SCADA database. 


For non-ABB DCS suppliers you can read the data points from the DCS supplier and 
store the current value and status in corresponding Basic Objects. In a Master system 
you can also configure the Basic Objects to allow events and alarms to be created and 
presented on the Advant OCS operator stations. This will give you a complete 
overview of the plant as if all parts of it where Advant OCS. 


coExecutor objects - Encapsulation and execution of applications 


The coExecutor object gives you the ability to execute your own or third party application 
software in IMS in a controlled way,. 


coRTM objects - Run time measurement 


coRTM objects provide a basic run time measurement functionality. You can get 
information about how long pumps, motors and other devices have been running and how 
many times they are started and stopped. 


coBasicCalc - Simple, high-performance calculations 


Using the coBasicCalc objects, you can build simple calculations on Advant OCS objects 
without any knowledge about programming. With the coBasicCalc object type instances, 
you can perform the most common arithmetical operations on a number (up to 10) of 
object values and store the result in the objects’ own value attribute. 


In addition to these Basic Objects, you can import the User Objects built with Object Type 
Builder by you and by ABB. All these object types can be handled using the powerful tools of 
Object Handling. 


The Object Handling also lets you configure, execute and monitor the status of Basic and User 
Objects and consists of: 


A run time environment with a status display 
You can execute User Objects in a number of ways in the run time environment including: 


—  Time-controlled execution at cyclic intervals or at specific times. 
Execution starting at an absolute time is also supported. 


— Triggered execution, activated by an update of an input object. 


You define the execution control, which is unique for every object instance, when the 
object is configured. 


The run-time environment also provides a status display which gives you the ability to 
monitor, activate and deactivate object instances. 


1. 


In Master both events and alarms can be created. In MOD 300 this is restricted to TCL Billboard messages. 
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The User Objects are unique instances in the Advant OCS distributed environment. Any 
Advant OCS client such as an AdvaInform Display or Operator Station display, a User 
API program, SQL*Connect, Forms Displays or another User Object can access it. 


° Configuration tools, interactive and bulk 


You can use the Object Handling configuration tool to create, delete, modify, copy, 
activate and deactivate User Object instances of any object type. You configure the 
object’s execution at the same time. 


Object instances can also be configured from a text file. Object Handling provides a tool to 
load instances from text files as well as dump instance configuration data into text files. 


This guide is intended for engineers configuring and executing User Objects. To design and 
implement applications as User Objects in IMS, you need the AdvaBuild Object Type Builder 
option, described in detail in the AdvaBuild Object Type Builder User's Guide. 


1.2 Equipment Requirements 


3BSE 001 013R0501 


Object Handling is an IMS option designed to run in conjunction with the AdvaInform Basic 
Functions. It runs on all Advant Station 500 Series IMS workstations. 
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1.3 How to Use This Book 


1.3.1 Documentation Structure 


Figure 1-1 shows the basic structure of Advant documentation. Each document, whether it is 
describing and referencing hardware or software, is built around this one structure, making it 
easy for you to locate related information in any of the documents. 


Chapter ‘ 
Seu ies Runtime 
Introduction Installation Belang. Operation Maintenance | | Appendices Index 
General Site Planning Design Product Preventive Appendix A 
Information Environment Considerations Operation Maintenance Object Name 
Syntax and 
Equipment Setup Capacity & Operating Hardware Time Abbr. 
Requirements Performance Overview Indicators 
Shut-down Appendix B 
Manual | Procedures Software Runtime Error Object Handlers 
Organization ov Setup Tutorial Messages Commands 
art-u 
Conventions Procedures Tutorial Operating Fault Finding Appendix C 
Instructions & User Repair ObjectUtil 
Related Product Application Commands 
Documentation Verification Procedures Operation of 
, , the Basic Appendix D 
Release Configuration/ Objects External 
History Application Communication 
Building Menus Library 
Terminology 
Product . Appendix E 
Overview Section Views Toward 


fi ion D 
User Interface Configuration Data 


Figure 1-1. Document Structure 


Chapter 1, Introduction 


Basic information about Object Handling. 


Chapter 2, Installation 


Step-by-step instructions on how to install Object Handling software. 


Chapter 3, Configuration/Application Building 


Describes how to use the configuration display. It includes examples of typical configuration 
steps, presented in a tutorial, and a detailed description of Object Handling’s menus and their 
functions. 
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Chapter 4, Runtime Operation 


Additional information about the run time environment. 


Chapter 5, Maintenance 


If you need help. 


Appendix A, Object Name Syntax and Time Abbreviations 


Information such as object names syntax and acceptable abbreviations for days and months. 


Appendix B, Object Handlers Commands 


Information about Object Handlers. 


Appendix C, ObjectUtil Commands 


Information about ObjectUtil Commands. 


Appendix D, External Communication Library 


Information about External Communication Library. 


Appendix E, Views towards Configuration Data 


Information about views towards configuration data. 


1.3.2 Differences Between Systems with Master and MOD 300 Software 
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The following is a summary of the differences in AdvaInform Object Handling for system with 
Master software and systems with MOD 300 software. 


The Basic Objects differ in the following ways: 


In a Master system the process object types AI,AO, DI, DO, DAT and TEXT exist also in 
the controllers. The operator station has object displays and display elements for them. 
The object types exists also in Object Handling in MOD 300 but are less useful due to 
the limited support by the rest of the system. 


The MOD 300 process objects DATA_FCM and VA_STRING_FCM exist only in 
the MOD 300 system. 


The coRTM usage is limited in the MOD 300 software as there is no DI object in the 
controller. 


The coBasicCalc object type is more useful in a Master system as the presentation of it and 
the event and alarm messages are supported by the Master operator station. 


The event and alarm handling differs. In Master, events, alarms and alarm acknowledge is 
supported. In MOD 300, TCL Billboard Messages can be created. 


The support of Object Handling differs between the Master and the MOD 300 operator stations. 
The MOD 300 operator stations is restricted to support existing MOD 300 object types while it 
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1.4 Conventions 
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is possible to add display elements that support new user object types on the Master operator 
station. With AdvaInform Display however this is not a problem. 


The following conventions are used throughout this guide. 


Table 1-1. Conventions 


Example 


.. refer to the Advalnform 
Object Handling User’s 
Guide.. 


.. the very first time you .. 


.. press the Return key .. 


.. press the space bar .. 


.. press <Return> .. 


Click or Single Click 
Double Click 
.. SCtrl-C> .. 


.. press the OK button .. 


.. select New from the File 
ment .. 


.. select File - New ... 


.. enter TIC132 into .. 


Type of information 


References to other books are written in /talics. 


Italics used for emphasis. 


The names of keyboard keys are written in Times (same as for 
the rest of the text) and in the same way as on the keyboard 
(initial capital letter for example) in plain text. 


Lowercase letters are used for the name of a key that is not 
labeled on the keyboard. 


In tables and procedures, angle brackets replace the word 
“key.” 


Click the left mouse button 
Double click the left mouse button 


A dash is used to indicate that you must simultaneously press 
several keys - Ctrl and C in the example. 


Push and toggle buttons are written the same way as they 
appear on the display. Also, in descriptions, tables and 
procedures, the word “button” is used in conjunction with its 
name. 


Initial capital letters are used for the name of menu items. 


Short for select New from the File menu (above). 


In a tutorial, for example, you may be told to enter a value in a 
field. The value is then written bold faced. 


Other conventions: 


In procedures and tutorials for example, output on the screen is written in Courier: 


Entered value is not valid. The value must be 0-30. 
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User input is written in bold face: 


TIC132 


1.5 Related Documentation 
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Enter an object name: 


Table 1-2. Related Documentation 


Category Title Description 

Hardware Advant Station 520 Hardware These books covers installation and 

Advant Station 530 Hardware maintenance of hardware for an Advant 
Station. 

Station Advant Station 500 Series IMS User’s Guide _| This book provides instructions for system 
administration functions such as backup and 
restore. 

Software Advalnform Basic Functions User’s Guide This book describes the basic functions that 
support all Advalnform software packages. 

Options Advalnform History User’s Guide This book describes the History function, 
useful if you want to log Basic and User 
Objects. 

Other AdvaBuild Object Type Builder User’s Guide _| This book describes how to use the Object 
Type Builder option 

Other Advalnform Object Types Reference Manual | This book describes the accessible objects in 
the Advant OCS. 


3BSE 001 013R0501 


1-7 


Advalnform® Object Handling User’s Guide 
Chapter 1 Introduction 


1.6 Release History 


Table 1-3. Release History 


Version 


Description 


1.0 


The initial release of Object Handling for the Advant Station 500 Series. 


1.4 


External Communication - EC - library which supports integration of foreign 
vendor systems with IMS 


Utility ObjectUtil added. 


Improved dump and load of objects instances to and from text files. 
The ability to balance the load User Objects apply on the controllers. 


Synchronous output as well as buffered asynchronous output from User 

Objects. 

Synchronous handling of commands allows for return of parameters from 

given commands, buffered asynchronous output improves performance as 

all output commands are sent together. 

Support for a more sophisticated event triggering functionality. 

Three new basic objects: 

° Run Time Measurement - Measures the time Your devices run and the 
number of starts and stops. Generates event messages to operator 
stations when run time limits are exceeded. 

° Basic Calculation - Calculates sum, average or a number of other 
mathematical algorithms from 2 to 10 inputs. The result is evaluated 
towards alarm limits. Data storage, alarm handling and presentation is 
done in AI object attributes. 

. Executor - You can configure this object to execute any third party or 
application software of your own choice. 


Execution configuration supports two types of scheduling: 

° Schema scheduling with granularity in seconds. 

° Cyclic execution with intervals in seconds 

Object Status Display 

° Monitoring, activation and deactivation of object instances 
Executor object type provided in MOD 300 IMS as well. 

TCL Billboard messages supported in MOD 300. 


Supports HP-UX 10.20 
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The following acronyms are used in this document: 
IMS Information Management Station 

OS Operator Station 

OTD Object Type Definition. 


OTDL Object Type Definition Language. The name of the definition language used to 
describe object types. 


AC Advant Controller 
UPS Uninterruptable Power Supply 


1.7.2 User Object Terminology 
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A brief introduction to applications that appear as objects is provided so that you can fully 
understand this guide without reading the AdvaBuild Object Type Builder User’s Guide. 


Data Requests 


The public data of the 
application is requested by 
operators and other applications 


Public Data 

oe i (Public Data) Operation Requests 
Reading Application Code odes fr oe 
and writing (operations) Rom onner 

data from / applications to 

to other ; execute operations 
applications Qperating 

(objects) ystem 


Events and Alarms or TCL Billboard Messages 
Messages are sent to the 
event and alarm system 


Figure 1-2. A Typical Application 
A typical application reads data from and stores data to, other applications. It allows other 


applications to read its public data and handles requests to perform certain operations. It can 
also produce events/alarms (Master) or TCL Billboard Messages (MOD 300). 
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Using an object-oriented approach, you can describe any application as an object. Figure 1-3 
shows a typical application and how any application can be described as a User Object: 


Core System 
SUBSCRIPTIONS 


On request and as 
a result of EVENTS 


ATTRIBUTES 


Normal \f Command 
Operation )\ Operation 


CONNECTIONS 


Subscriptions 


COMMANDS COMMANDS 


Messages to the 
Event and Alarm 
subscribers 


Figure 1-3. The Application Described as a User Object 


The application code is split into two parts: 


Normal Operation: The algorithm to combine input data (attributes and connections) to 
create output data. Normal Operation is executed when the object: 


- is started for the first time after a shutdown, 


is started by a cyclic schedule, 


is started by an event, or 
— is given the command NormalOperation. 


Command Operation: The service to execute in response to a command. 


Three facilities available through the core system are used for the interaction between objects: 


Command: A function provided by the core system to request the execution of an object 
Operation. As a result, the object executes the corresponding Normal or Command 
Operation. 


Subscription: A function provided by the core system to read data (attributes) with. 

The request can ask for data to be returned immediately, at cyclic intervals or when a 
specified Event occurs (to be triggered). In Object Type Builder there is also another usage 
of the term subscription: A subscription is a list of attributes provided in one request. 


Event: Events are defined with an event declaration. A User Object can declare an event 
that other objects e.g. User Objects subscribe on. When the event occurs, the subscriber is 
activated. You program the raising of events in the Normal and Command Operations. 
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Inputs and outputs are described with two terms, attribute and connection: 


° Attribute: Describes the object’s public data. The application result is commonly stored in 
attributes, which also contain configured public information. Applications (other objects) 
can request the object’s public data through the core system using subscriptions or from 
the corresponding Oracle instance table using SQL. This is completely transparent for the 
application part of the User Object, you do not need to take any actions for this to function. 


° Connection: Describes connections to other objects. The data from the input connections 
(attributes) are automatically read (using subscriptions) each time an object instance is 
executed. Each output to another object through an output connection is requested in the 
User Object application code (Normal and Command Operations) and will result in 
sending a command to the other object. 


Finally, messages to the Messages Logs and Event and Alarm System are supported: 


° You request the sending of messages to the Message Log (if the History Option is 
installed) and to Event and Alarm subscribers, hereafter called E & A subscribers, 
from the Normal and Command Operations. Typical E & A subscribers are the Event and 
Alarm lists in operator stations (Master) or TCL Billboard (MOD 300). 


Subscriptions 


Core system Subscriptions Core system 


(on demand 
ATTRIBUTES ATTRIBUTES 
Commands 


or triggered) 
Ope- 
rations | et 


Subscriptions 


Commands 
Commands 
POPE rae atid 


Event Messages 


Figure 1-4. Interaction Between Two Objects 
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1.7.3 Definition of Terms 


Basic Objects 


Core System 


Advalnform Basic 
Functions 


Advalnform Database 


IMS Main Menu 


Object 


Process Objects 


System Objects 


User Object Type 


The process-objects Al, DI, AO, DO, DAT, Text are 
implemented as User Objects and provided in the Object 
handling. 


All nodes in the Advant OCS systems communicate with 
each other through the core system. The core system 
provides services for the system and user applications 
(objects).Using these services, the objects can communicate 
with each other whether they reside in the same node or in 
different nodes of different types. 


The minimum software required for Advalnform software. The 
various functions included in the Basic Software are 
described in the Adva/nform Basic Functions User’s Guide. 


The Advalnform database is based upon the relational 
database Oracle. 


The IMS entry menu. From this menu, all of the installed 
Advalnform and AdvaBuild options can be selected. Using 
the IMS main menu is described in detail in the Advalnform 
Basic Functions User’s Guide. 


Any entity in the Advant OCS system that represents a user- 
visible function or piece of equipment. An object is user- 
visible if it is configurable by the user of the products, or if it 
delivers global data or performs commands. Objects are split 
into Process objects and System objects. 


Entities representing control and supervision functions. For 
example Al, AO, and PIDCON. 


Software utilizing process supervision and management 
programs (functions), for example, system status objects. 


A description of a type of object built with the Object Type 
Builder. The User Object type has a framework described by 
the attributes, connections, commands and events and 
behaves as described by the operations. 
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Advant OCS is an object-oriented system. A large number of pre-defined objects exist in Advant 
OCS. They provide functionality for data collection, process control and supervision, system 
status, long-term data storage etc. 


For any user of Advant OCS it is also important that the application-specific problems can be 
solved. The most powerful concept that is provided for application development in IMS is that 
of User Objects. The functionality of User Objects is provided as two separate options: 


° AdvaBuild Object Type Builder, also referred to as Object Type Builder 


Object Type Builder is the development environment. It is a complete environment for 
design and implementation of applications in the form of objects. The result of the 
development - in the form of Object Types - is exported to the Object Handling option. 
This means that many IMS systems with User Object can be served by one development 
machine containing Object Type Builder. See figure Figure 1-5. 


° AdvaInform Object Handling, also referred to as Object Handling 


Object Handling provides the tools for configuration, execution and status monitoring of 
User Objects. There are a number of pre-defined User Objects, so called Basic Objects, 
included in Object Handling. These, together with the application specific User Objects 
built for the plant, are executed with the help of Object Handling. 


The Object Type Builder and Object Handling provide a consistent, uniform and user-friendly 
environment for developing standard and user-specific applications. Many of the ABB 
functions/products which are specific for a certain type of industry are provided as User 
Objects. The ABB industry specialists have used Object Type Builder to develop the solutions. 
They are then installed and executed by using Object Handling. 


Examples of applications developed, or suitable to develop, as User Objects are component 
lifetime calculations, run-time measurement and various types of optimizations. 


Development and RTT 

Test IMS Tarant INC 
Target IMS 

Object Type Builder eee Ll 

Object Handling > Object Handling 


ABB products 
delivered as 
User Object Types 


Figure 1-5. Usage of Object Type Builder and Object Handling 


Object Handling makes applications for production planning, quality supervision and process 
optimization visible on the operator station, on AdvalInform Display and for SQL clients. See 
Figure 1-6. 
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| AdvalInform Display 


Operator Stations 


History 


AdvaInform Reports 


_ 


Forms Displays 


PC clients 


IMS 
allo 
Application : : 
built as Object Handling oe 
User Object APL 


Types 
He Configuration 


pre- 
defined 


Objects in Controllers and in other IMS:es 


Figure 1-6. Object Handling makes applications visible for all types of object clients 


1.9 User Interface 


User interaction is thoroughly described in Chapter 3, Configuration/Application Building. 
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Chapter 2 Installation 


2.1 Site Planning Environment 


Object Handling requires the AdvaInform Basic Function for operation. See the Advant 
Station 500 Series IMS User’s Guide for information about site planning, installation, and 
diagnostics. 


2.2 Setup 


2.2.1 Hardware 


For details regarding the hardware, refer to the Advant Station 500 Series IMS User’s Guide and 
the relevant Advant Station 5xx Hardware User’s Guide. 


2.2.2 Software Installation 


Generally, the AdvaInform Object Handling software is loaded onto the Advant Station at the 
factory prior to delivery. Therefore, you generally do not have to load the software. 


If you, for some reason, have to install or remove the Object Handling software, refer to the 
Advant Station 500 Series IMS Users Guide for instructions. 


2.2.2.1 Selecting the Object Handling Facilities 


The Object Handling facilities are activated from the main AdvaInform menu by selecting 
Object handling and then the sub menu Object Configuration or Object Handlers. 


a Advant Station 500 Information Management Station | ° | 
File Station AdvaBuild Advainform AdvaTalk Session Settings Help 


Object Handling & Obi i : 
ject Configuration 

Reports Object Status 

Object Handlers 


Figure 2-1. Selecting the Object Configuration and Object Handler facilities 
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2.3 Shut-Down Procedures 


Object configuration is an interactive tool which you can terminate at any time. 

All User Objects, including basic objects, are executed in an installed run time environment 
called an Object Handler. The Object Handlers for basic objects are automatically included in 
the start-up and shutdown procedures of your IMS station when Object Handling is installed. 
They are called basichandler, basic2handler and modbasichandler 


Other Object Handlers are installed by ABB, or by the System manager, when applications built 
with the Object Type Builder are ready for installation. 


2.4 Start-Up Procedures 


Select Object Handling, from the IMS Main menu to activate the Object Configuration display. 
See Figure 2-1. 


2.4.1 Transfer an Object Handler to Another Node 


2-2 


An Object Handler consists of an executable file and the definitions of the object types it can 
handle. Make sure that the target machine has the same Operating system and IMS software 
version. Furthermore, it’s type directory must be updated with the object types that you install. 
See the Advalnform Basic Functions User’s Guide for information on how to create and install a 
new type directory. 


NOTE 


You must be logged in as the user imsmgr to perform the transfer functions. 


For the Advant Station 500 Series, do as follows: 

1. Select ‘Object Handlers’ from AdvaInform Object Handling menu. 

2. Change the default directory to a directory with write access and located on a disk with at 
least 2 Mb empty space. 
$ ObjectHandlers <ENTER> 
ObjectHandlers x.y-z> dump object_handler_name 


ObjectHandlers x.y-z> exit 


$ 
With this command you create the file <object_handler_name>TRANSFERdmp. 


3. As next step, use the utility ftp to copy the files to the target machine: 
$ ftp <node_name or internet_address> 
Connected to node_name. 
220 node_name FTP server (Version - - ) ready. 
Name (node_name-:user_name): 
331 Password required for user_name. 
Password: 
230 User user_name logged in. 


Remote system type is UNIX. 
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Using binary mode to transfer files. 

ftp> cd <to a directory on the target machine with write access to and enough free disk space> 
ftp> put object_handler_nameTRANSFER.tar 

ftp> bye 

22x Goodbye. 

Finally, use the ObjectHandler utility on the target machine to unpack it. After starting the 
Object Handler terminal window enter the following: 

$ ObjectHandlers <ENTER> 

Change the default directory to the directory you copied the file to. 

ObjectHandlers xy.z> load object_handler_name 

ObjectHandlers xy.z> start object_handler_name 


ObjectHandlers xy.z> exit 
Where object_handler_name is the name of the object handler to load and start. 


See Appendix C, ObjectUtil Commands for detailed information of the Object Handlers 
utility. 


2.5 Product Verification 


When the Object Configuration display is activated, choose Help-On Version from the Help 
menu to determine the object configuration version. 
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3.1 Design Consideration 


3.1.1 General 


Design considerations for objects that are related to the object type design are described in the 
AdvaBuild Object Type Builder User’s Guide. 


There are a few actions that you can do in order to improve performance of your user objects 
that is not related to the design of the objects. These actions are described in the following 
sections. 


3.1.2 Data Shadowing to the Database 


By default, when a User Object attribute is updated, the corresponding attribute information in 
the database table is also updated. For some object types or instances, this is not required or 
perhaps not even desired as it puts an additional and significant load on the system. A typical 
example is when many objects are updated frequently. They should then have their data 
shadowing inactive. See Appendix C, ObjectUtil Commands for details on how to handle 
database shadowing. 


To make sure that they are still available from SQL, add the object type to the SQL*Connect. 


3.1.3 Selecting Method to Read Input Connections 


The default method to read input connections keeps all references to the input objects between 
each execution of the object. This method is preferred because of its high performance. If you 
run out of memory on the RTA board, you can use another method. This method sets up all 
references, reads the data and then removes the references each time the object executes. 
Therefore it requires less memory. See Appendix C, ObjectUtil Commands for details on how to 
select read method. 


3.1.4 Execution Configuration 


An object can be configured to execute in one of the following modes: 
° No cyclic or scheduled execution 
° Scheduled execution, which means that the object shall be executed at specific times. 


° Cyclic execution, which means that the object shall execute with an interval specified in 
seconds. 
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3.1.5 Load Balancing 


If many User Objects execute simultaneously the amount of data requests from them to the 
controllers may become too large resulting in overload situations and failure to read data 
properly. A load balance function is provided to prevent overloads. You can configure how 
many User Objects that may request for data simultaneously. See Appendix C, ObjectUtil 
Commands for details on how to tune the load balancing. 


3.2 Capacity and Performance 


See the Advant Station 500 Series IMS User’s Guide for details in Capacity and Performance. 


3.3 Software Setup 


To start the Object Configuration tool, select Object Handling and then Object Configuration 
from the AdvaInform menu of the IMS menu. To start the Object Handler functions, select 
Object Handling and then Object Handlers. To start Object Status, first select Object 
Handling and then Object Status. 


= Advant Station 500 Information Management Station | ° | 
File Station AdvaBuild Advainform AdvaTalk Session Settings Help Help 


Object Handling 
Reports 


% Object Configuration 
Object Status 
Object Handlers 


Figure 3-1. Selecting the Object Configuration and Object Handler functions 


3.4 Tutorial 
The following step-by-step tutorial demonstrates how to configure an object. Two object types 
are used in the examples: 
° A basic object, called an AI object, and 


° A small application object type called average. 


NOTE 


It is important that you understand the terms attribute, Normal Operation and 
connection before continuing with the following tutorial. If you are uncertain 
about these terms, see Section 1.7, Terminology before continuing. 


The tutorial showing you how to use the EC library is included in Appendix D, External 
Communication Library. 
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3.4.1 Creation of a New Analog Input 
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With the Object Configuration tool started, as described in Section 3.3, Software Setup, follow 


these basic steps to configure a new object: 


1. Select the object type you want to instantiate using Open from the File menu. 
2. Select New from the File Menu 
3. Enter a unique name 
4. Configure the attributes and connections. 
5. Select a Normal Operation 
6. Specify cyclic execution 
7. Save the object 
8. Start the object. 
NOTE 
Steps 5 and 6 are optional. When an object is created, the first Normal Operation 
(Step 5) is always selected by default; and the cyclic execution (Step 6) is set at 
not active by default. For objects without mandatory connections, Step 4 is also 
optional; the attributes are given the default values for the object type when the 
object is created. 
= Object Configuration 0 
Object Name: | G3inletTemp Object State: | Stopped Start 
Step 8 
i Object Type: | Al a Stop 
Description: InletTemp Gas turbine 3| Normal OP: | 1 Standard operation 
Step 5 — | Parts Attributes/Connections | Attribute: RANGE_MAX 
UNIT Ay 400.0 
Al 
Connection RANGE-WAD [ |} 
NO_OF_DEC 
LL SUBSYSTEM OK Cancel Help 
eal) CLASS 
Step 6 HI_LIM2 
HI_LIM1 
LO_LiM1 
LO_LIM2 
USE_HI_LIM2 
USE_HI_LIM1 
UES_LO_LIM1 
IM) 
Figure 3-2. Object Configuration Tool 
Task 


Create a new AI object named G3InletTemp. The description shall be Inlet temp 
Gas turbine 3, the event and alarm handling according to the default setup and the 
RANGE_MAX< attribute shall be 400.0. 
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Select Object Type Al and Request a New Object 
1. Choose Open from the File menu. The Object Type dialog box is displayed. 
2. Single click on AT to select it from the Object Type list. 


— Object Types Objects 
Al G2inletTemp 
AO G2OutTemp 
DAT G2Pressure1 
DATA FCM G2Pressure2 
dD 
DO 
coBasicCalc 
coExecutor 
coRT' 

Text 
VA_STRING_FCM 
Selection 
G2InletTemp 
OK Apply Cancel Help 


Figure 3-3. Object Type Dialog Box 


3. Choose New from the File menu. The New Name dialog box is displayed. 
4. Enter G3InletTemp in the New object name field and click on OK. 


=| New Name 


New object name 
G3inletTemp 


OK Cancel Help 


Figure 3-4. New Name Dialog Box 


Configure the Attributes 


The AI object attributes are given defaults according to the object type definition. The standard 
Normal Operation is used and no cyclic execution is required. To modify the description and 
RANGE_MAX attributes: 

1. Enter the new description in the Description field and press <ENTER>. See Figure 3-2. 


2. Select RANGE_MAX from the Attributes/Connections list. Enter 400.0 in the Attribute 
field. Click OK. See Figure 3-2. 


Save and Start the Object 


1. Choose Save from the File menu. 


2. Click on the Start button to start the object. When the object is successfully started, the 
Object State field switches from Stopped to Started. See Figure 3-2. 
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3.4.2 Copy an Average Object 


Task 


Copy the average object mvTempBuilding1 and create the new object mvTempBuilding2. 
Change the input connections (temperatures read through objects in Controllers: 
B2Room1Temp, B2Room2Temp, B2Room1Temp). 


All attributes of the average object can be the same (copied), but the description must reflect 
that this is the average temperature of Building 2. 


Select the Object mvTempBuilding1 and Request a Copy 


See the previous example for a description on how to start the Object Configuration and how to 
perform steps 1, 2, 6 and 11. 


1. Choose Open from the File menu. The Object Type dialog box is displayed. 
Single click on average to select it from the Object Type list. 

Enter mvTempBuilding1 in the selection field of the Open dialog. Click on OK. 
Choose Copy from the File menu. The Copy Name dialog box is displayed. 


PoP 


Enter mvTempBuilding2 in the New object name field and click on OK. 


= | Copy Name 


New object name 


mvTempBuilding2 


OK Cancel Help 


Figure 3-5. Copy Name Dialog Box 


Configure the Attributes and Connections 


All the object attributes are copied. The same Normal Operation is used and the cyclic execution 
is set to five minutes. Do the following steps: 


1. Enter Average indoor temp B2 followed by <ENTER> as the new description. 


2. Select connection 1, obj1, from the Attributes/Connections list and enter B2ZRoom1Temp 
followed by <ENTER> in the Name field to change the object name. Click on the 
Attribute push button and select the attribute VALUE from the attribute list that pops up. 
Save the connection by clicking on OK. 
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Attributes/Connections Single Connection (Optional) Float Input 

loLim Not Configured 

hiLim 

limTr & Constant Value 0 

obj1 . 

obj? Object Connection 

obj3 N ; 

optObj ame: B2Room1Temp 
Attribute: || VALUE 


Suppress error actions 


OK Cancel Help 


Figure 3-6. Lower right corner of Object Configuration with Object Connection Active 


3. Select connections 2 and 3 from the Attributes/Connections lists, enter B2ZRoom2Temp 
and B2Room3Temp, respectively, to change the object names. 


4. Select the connection optObj and click on the Not Configured toggle button to disable the 
fourth connection. Building 2 has only three rooms. Save using OK. 


Attributes/Connections Single Connection (Optional) Float Input 


@Not Configured <a 


loLim 
ee Constant Value 0 
limTr 
obj! ) Object Connection 
obj2 
ois Name: 
optObj 
Attribute: 


Suppress error actions 


OK Cancel Help 


Figure 3-7. Lower right corner of Object Configuration with Not Configured Selected 


Save and Start the Object 


1. Choose Save from the File menu to save the object. 


NOTE 


An error message is presented if all compulsory attributes and connections are not 
properly configured when you attempt to save. If these attributes and connections 
are not correctly configured, the object is not saved. 


2. Click on the Start button to start the object. When the object is successfully started, 
the Object State field switches from Stopped to Started. 
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3.5 Application Procedures 


Object Handling contains four functions: 
° Object configuration 

° Object run time environment 

° Basic objects 

° EC programming library 


The object run time environment is described in Section 4.3.3.3, Show an Object Type’s 
Existing Attributes. 


The Basic Objects are described as separate data sheets, see the Advalnform Object Type 
Reference Manual. Also, see the AdvaBuild Object Type Builder User’s Guide on how to 
interact with the Basic Objects and other ready-made User Objects. 


The EC library is described in a separate Appendix D, External Communication Library. 


3.5.1 Object Configuration 


The Object Configuration tool (Object Configuration) is started from the IMS menu as 
described in Section 3.3, Software Setup. You must identify yourself through a log-in procedure 
when logging-on. Object Configuration privileges and user authority are assigned according to 
the log-in information. 


At start-up, Object Configuration selects the first available object type and the first available 
object of that type (sorted alphanumerically). If no object exists, no object instance information 
is displayed. 


The following configurable attributes are common for all object types: 
° The object name a unique identifier for the object. 


° Normal Operation a basic algorithm to be executed when the object is started for 
cyclic or event-driven execution. 


° Scheduled execution describes when the object is to execute if applicable. 
Each object type may also have a number of additional configurable attributes and connections. 


Object Configuration works locally in the node where it executes, so you can only use it to 
display and configure objects and object types residing in that node. 


3.5.2 Authorization 
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When you select an object, an attempt is made to open it for read and write purposes. 

If the object is active, write access is not granted. If another configuration tool has received 
write access to the object, your request is denied. Only one user can write access an object at 
one time. Access is granted on a first-come, first-served basis. 


To configure an active object, you must stop it. When the object is stopped, you are 
automatically granted write access. After a successful configuration, start the object again. 
See Section 3.6.5, Area 1: General Information for All Object Types for more information on 
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how to start and stop objects. If you try to change objects that are started or that do not have 
write access, a warning message informs you that you only have read access. 


3.5.3 Documenting Object Instances 


The attributes of User Object instances are always available in Oracle® tables. When the first 
instance is created, a relational DB table (instance table) is automatically created. Each attribute 
of your object type will get a corresponding column in the table. Each instance will get it’s own 
row in the table: 


Advalnform database 
econ YY instance table 


Attributes 
Object — The 
J attribute 
One instance, of the 
one row specific 
instance 


Figure 3-8. Relation between object type, instances and the database 
For each object type, its name is the base for the Oracle table name according to the following 
name convention: 
userobjects.CO_object_type_name_INST 


For example, the object type named average has the following Oracle table as its instance table 
(SQL*Plus®): 


SQL> describe userobjects.co_average_inst; 


Name Null? Type 


INST_ID NOT NULL NUMBER (6) 
NAME NOT NULL CHAR(20) 
DESCRIPTION CHAR (28) 
STATUS NUMBER 
LOLIM NUMBER (8, 3) 
HILIM NUMBER (8, 3) 
VALUE NUMBER (8, 3) 
LIMTR NUMBER (5) 
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To document existing instances, you can use either SQL*Plus or Oracle Reports ® to make 
selections such as (SQL*Plus): 


SQL> select name, description from userobjects.co_average_inst 
where name like ’av%’; 


NAME DESCRIPTION 

av3 Third set of pumps 

av4 Fourth set of pumps 
av31 meanv. temp area 31 


All user object instance tables are available for read access for any IMS user. Please refer to the 
Advalnform Basic Functions User’s Guide for information on how to start and use the different 
database tools (SQL*Plus, Oracle Reports etc.) 


3.6 Configuration/Application Building Menus 


3.6.1 Object Configuration Layout 
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The Object Configuration tool works locally in the node where it executes, so you can only use 
it to display and configure objects and object types residing in that node. 


You must configure a User Object before it can be executed and used in the run time 
environment. Object Configuration is a full graphical tool. It consists of a main window and a 
number of pop-up windows. The main window contains a menu bar featuring File and Help 
menus. 


The main window can be broken down into three areas, as in Figure 3-9: 


1. General information common for all objects is displayed in this area, including the object 
type and name, the description, the Normal Operation and the current execution state. 
The object execution can be started and stopped by clicking on dedicated push buttons in 
this area. 


2. This area consists of two selection boxes where you can select the attribute/connection you 
wish to work with. 
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(1) 


(2) 


3. The attribute/connection you have selected is displayed in this area. You can also make 
modifications of the selected attribute/connection here. 


co 


Object Configuration 


i) 


Object Name: 
Object Type: 


Description: 


B2RoomiTemp 


Al 


Indoor temp Room1 B2 


Object State: 


Normal OP: 


Stopped Start 


Stop 


1 Standard Operation 


Parts 


Attributes/Connections 


Attribute: 


Al 


UNIT 


RANGE_MIN 


(ALL) 


RANGE_MAX 


ERROR_TREAT 
NO_OF_DEC 
SUBSYSTEM 
CLASS 
HI_LIM2 
HI_LIM4 
LO_Lim1 
LO_LIM2 
USE_HI_LIM2 
USE_HI_LIM1 
UES _LO_LIM1 


lA\ 


UNIT 


deg C 


OK 


Cancel Help 


IM} 


(3) 


Figure 3-9. Layout of the Object Configuration Tool 


3.6.2 Object Selection 


You can select the object you want to work with from the Open selection boxes described in 
Section 3.6.8.2, File - Open. Choose Open from the File menu to start the selection boxes. 
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3.6.3 Save Dialog Box 


The Save dialog box is started when you modify the selected object and: 
° Choose New or Exit from the File menu, 


° Select another object type or object name from the Object selection box. 


= | Modified object 


Question 


Q Object Is Modified. Ignore Changes? 


YES NO 


Figure 3-10. Save Dialog Box 


Fields, Push Buttons and Push Keys 
° Yes 
Click on the Yes button to ignore all changes. 
« No 
Click on the No button to cancel the requested action. 
° <ENTER> 


Press <ENTER> and the default action is performed. The default action depends on the 
selection made the last time the question was answered. It is marked with a double frame. 
In the figure above, Yes is the default. 
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3.6.4 Help 


Choose any of the Help items from the Help menu for general Help. For specific Help with any 
of the dialog boxes, click on the Help button in the dialog box. Help is always displayed as a 
Help window: 


= Index ° | 


Help on Index 


The help on index gives the ability to select each help text of the 
Object Configuration. 


gE [mee] 
Open Box ji 


New Dialog 
Copy Dialog 


Figure 3-11, The Help window 


The help window displays help text on the selected subject. The help windows file menu 
contains two items, Keep text and Close. Keep text is a toggle that, when set, specifies that the 
text in the window should not be changed when help is requested again (that is a new help 
window is opened). Close closes the help window. 


If there are indices (references) to other help texts, those are displayed in the bottom of the help 
window as shown in Figure 3-11. By double clicking on such a reference that help text will be 
presented. The previous index is displayed in the index area when the new text is presented. 
By double clicking on it you return to the first text. This way you can step through the help text 
hierarchy. 


3-12 3BSE 001 013R0501 


Advalnform® Object Handling User’s Guide 
Section 3.6.5 Area 1: General Information for All Object Types 


3.6.5 Area 1: General Information for All Object Types 
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SI 


Object Configuration 


Object Name: 
Object Type: 


Description: 


B2Room1Temp 


Al 


Indoor temp Room1 B2 


Object State: 


Normal Op: 


Stopped 


Start 


Stop 


1 Standard Operation 


Figure 3-12. Object Config. Tool Showing Basic Data applicable for All Object Types 


The currently selected object’s name, object type and description are presented in the upper left 
comer of the tool. Started or Stopped in the Object State field indicates the object’s state. 

To change the state, click on the Start or Stop button, located to the right of the Object State: 
field. The currently selected Normal Operation is represented by a number 1-10 and a 


corresponding description. 


Fields, Push Buttons and Push Keys 


° Object Name 


The object name is displayed in the Object Name: field. 


° Object Type 


The object type name is displayed in the Object Type: field. 


° Description 


Enter and display the object description (up to 28 characters) in the Description: field. 


NOTE 


There are object types without any description, for example, DAT and Text. 
For instances of those object types, the description is presented as blank and you 


cannot modify it. 
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<ENTER> 


Press <ENTER> when you have entered the new description in the Description: field. 


= Normal Operations 


1 Standard Operation 
2 Variant 1 


Cancel Help 


Figure 3-13. Normal Operation Dialog Box 


Normal Op 


The number and description of the currently selected Normal Operation are displayed in 
this field. Click on the Normal Op: field and the Normal Operation dialog box pops up 
with a list of available Normal Operations. 


— Select the Normal Operation that you want by clicking on it. 


— Click on the Cancel button to close the dialog box without selecting a new Normal 
Operation. 

Object State 

Either Started or Stopped is displayed in the Object State: field to indicate the object’s 

current state. 

Start 

Click on the Start button if Stopped is displayed in the Object State field and you want to 


start the object. If the object is already started, or if the object is not open for write access, 
the Start button is shaded and cannot be selected. 


NOTE 


You must save any modifications made to the object before you can start it. 


Stop 


Click on the Stop button to stop a started object. You must click on the Start button to 
make the object begin executing again. If the object is stopped, the Stop button is shaded 
and cannot be selected. You can click on Stop even if the object has been modified since 
the last time it was saved. 
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3.6.6 Area 2: Part and Attribute List Selection Boxes 
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Parts Attributes/Connections | Attribute: hiLim 
averAttribute loLim 50 
compConnections hiLim 
optConnections limTR 
(ALL) ] 


OK Cancel Help 


Figure 3-14. Parts and Attributes/Connections Selection Boxes 


For large and complex object types, attributes and connections are often split into several parts 
to give you a better overview and better documentation of the object type. Each part consists of 
a number of attributes and/or connections. Select the part you wish to configure from the Parts 
list. The part name is highlighted and the corresponding list of attributes and connections 
appears in the scrolled Attributes/Connections list to the right. 


Selecting Items from the Parts and Attributes/Connections Lists 


You can select the following items from the Parts and Attributes/Connections Lists: 


° [ALL] is the Parts list default. All parts are listed along with their attributes and 
connections, which are listed in the same order. 


To select all parts after selecting a single part, click on [ALL]. [ALL] always appears at 
the bottom of the Parts list. 


° To select a part from the Parts lists, click on the part name. 


° Click on an attribute/connection name to select it. You can select any attribute or 
connection for inspection and/or configuration. 


The current value(s) of the selected attribute/connection is displayed in the Attribute field 
to the right of the scrolled Attributes/Connections list. This window has three different 
layouts depending on the type of attribute/connection selected. See Figure 3-15, 

Figure 3-16, and Figure 3-17. 
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3.6.7 Area 3: Attribute/Connection Data Windows 


There are three Attribute/Connection windows: 


3.6.7.1 Attribute Window 


3-16 


Attribute 
Single connection 


Object connection 


The OK button and the <ENTER> key have the same functionality for all three windows: 


Press <ENTER> to confirm data entry. The data is checked against the object type’s 
design constraints. If the data is not acceptable, an error message dialog box is displayed 
describing the error. 


Click on OK to save an attribute/connection after you have entered all the configuration 
information. If you select another attribute/connection and you have not saved the 
currently selected connection by clicking on OK, a message appears asking you if you 
wish to save the information before continuing. The Save dialog box is similar to the one 
described in Section 3.6.3, Save Dialog Box. 


Attribute: hiLim 


50 


OK Cancel Help 


Figure 3-15. Attribute Window, lower right corner of display 


Fields, Push Buttons And Push Keys 


Attribute 


The attribute name appears in the Attribute: field. 
Attribute field 


Enter the attribute value in the Attribute field. The current value is always displayed. 
OK 


Click on the OK button to accept and verify the entered value. See Table 3-1 for more 
information about verifications. 
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Click on the Cancel button to retrieve and display the attribute’s currently stored value. 


The new value that you entered is deleted. 


° Help 


Click on the Help button to view information about this window in a Help message box. 


° <ENTER> 


Press <ENTER> to accept and verify the entered value (performs the same function as 


OK). 


After you enter the value and press <ENTER> or click on OK, the value is checked. If the 
check is successful, the new value is accepted. If the value is not accepted, the old value is 
displayed again and the new value is deleted. Checks according to Table 3-1 are performed: 


Table 3-1. Attribute Data Verifications 


Data type 


Range tests 


Set tests 


Data type format 
checks 


Integer Small 
Integer Short 
Integer Long 


Toward the default 
range for the data 
type or toward the 
range given at 

object type design 


Toward the set 
defined at object 
type design (if any) 


Only numerical 
characters are 
allowed 


Unsigned Small 
Unsigned Short 
Unsigned Long 


Toward the default 
range for the data 
type or toward the 
range given at 


Toward the set 
defined at object 
type design (if any) 


Only numerical 
characters are 
allowed 


types based upon 
Bitset16 or Bitset32 


given at object type 
design 


object type design 
Float Toward the range __| Toward the set Only numerical 
Double given at object type | defined at object characters and “.” 
design (if any) type design (if any) | are allowed. “E-for- 
mat” is not. 
String Not valid Toward the set String length is 
defined at object checked 
type design (if any) 

Boolean Not valid Not valid The only allowed 
Boolean values 
are: true, false, 
TRUE, FALSE, t, f, 
T and F 

Local or global data | Toward the range Not valid Only numerical 


characters are 
allowed 


When you enter a new value, it is checked according to the table and, if accepted, is saved for 


the attribute. If it is not accepted, an appropriate error message is given. 
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3.6.7.2 Single Connection Window 
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A single connection is a connection to any attribute of a certain data type of an object type. 
Which object instance and which attribute is decided at configuration. You can alternatively 
specify a constant value to use as a replacement. If the single connection is optional, you may 
choose not to configure it at all. 


Single Connection (Optional) Float Input 
} Not Configured 


% Constant Value 20 


Object Connection 
Name: G2inletTemp1 


Attribute: || VALUE 


Suppress error actions 


OK Cancel Help 


Figure 3-16. Single Connection Window 
You can set a single connection to one of these three configurations: 
° Not Configured 
° Constant Value 
° Object Connection. 
Click on the appropriate radio button to select the configuration you choose. 
Fields, Push Buttons and Push Keys 
° (Optional) 
(Optional) is displayed at the top of the Single Connection window if this is an optional 


connection. When an object type is designed, it is determined whether a single connection 
will be compulsory or optional to configure. 


° Data Type 
The single connection data type is displayed to the right of the text Single Connection. 
° Input or Output 


Input or Output is displayed in the upper right-hand corner of the Single Connection 
window to indicate the single connection direction. Currently, only Input exists. 


° Not Configured 


Click on the Not Configured radio button connection if the connection is not used by the 
object instance. This selection is shaded for compulsory connections (not optional). 


° Constant Value 


Click on the Constant Value radio button to enter a constant value from the connection. 
Entering a constant value is similar to entering an attribute value. The current value is 
always displayed. For new objects, the field is blank or set to the default given at object 
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type design. Entered data is checked according to all default checks described in Table 3-1. 
Press <ENTER> when you have finished entering data. 


Object Connection 


Click on the Object Connection radio button and then enter an object name and a 
corresponding attribute name as follows: 


— Enter the name of an existing object! in the Name: field and press <ENTER>. 
A list of attributes matching the connections data type is fetched, and the first 
attribute is displayed in the Attribute: field. If no attribute matches the data type, 
the object name is not accepted. 


— Click on the Attribute field. A list of available attributes pops up (see Table 3-17). 


= Attributes 


RANGE _MIN 
RANGE_MAX 
VALUE 
HI_LIM2 
HI_LIM1 
LO_LIM1 
LO_LIM2 


Cancel Help 


Figure 3-17. Attributes Pop-Up List 


Click on any attribute in the list, or press <ENTER>, to select it. Click on Cancel to 
close the pop-up list without making a new selection. 


Suppress error actions 


Clicking on the Suppress error actions radio button turns the suppression flag on or off. 
Suppression affects the object’s error-handling regarding the reading of connected object 
values. If reading of a connection fails and error actions are not suppressed, the current 
object execution is terminated and the object’s error status is set to true. If suppression is 
on, the object execution is continued. See Section 4.3.4.1, Execution. 


OK and Cancel 


Click on the OK button to confirm and save the information entered on the screen. 
When you save the object, the information is made part of the object configuration. 
Click on the Cancel button to delete all the information you have entered since the last 
OK. Cancel retrieves the object connection existing when the object was retrieved or 
when the latest OK was implemented. 


Help 


Click on Help to view Help information about this dialog box in a Help message box. 


Existing object in the system where the IMS node resides. Can be an Advalnform object as well as a Process Station 
object. 
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3.6.7.3 Object Connection 


NOTE 


e An object connection is a connection to a specified object type. Only objects 
of that object type can be configured to that connection. By selecting the 
trigger facility, you can specify that the object you configure will be activated 
on event when the connected object generates a specific event. 


¢ Most MOD 300 Process Objects do not support so called Composite 
Attributes and they only give a limited support for Events. Therefore, you can 
very seldom use object connections to get input from MOD 300 Process 
Objects. Instead, use single connections. You shall however define the output 
towards MOD 300 Process Objects with Object Connections. 


If the connection is optional, you may choose not to configure it at all. 


Object Connection Input 
Not Configured 
@ Object Connection AI 


Name: G2inletTemp1 


Suppress error actions 


m@ Trigger || EVENT 


OK Cancel Help 


Figure 3-18. Object Connection Window 


Object connections can be optional. For optional connections, click on the Not Configured and 
Object Connection radio buttons, one at a time. 

Fields, Push Buttons and Push Keys 

° (Optional) 


(Optional) is displayed at the top of the Object Connection window if this is an optional 
connection. When an object type is designed, it is determined whether an object 
connection will be compulsory or optional to configure. 


° Input or Output 


Input or Output is displayed in the upper right-hand corner of the Object Connection 
window to indicate the object connection direction. 


° Not Configured 


Click on the Not Configured radio button connection if the connection is not used by the 
object instance. This selection is shaded for compulsory connections (not optional). 
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Object Connection ‘Object Type’ 


Click on the Object Connection radio button and enter the name of an existing object as 
follows: 


— Enter the name of an existing object! of the appropriate object type, as specified 
during the design of the object connection, in the Name field and press <ENTER>. If 
the object is of the correct type, it is accepted. If it is not accepted, or if it does not 
exist, an error message box is displayed. 


- ‘Object Type’ 


The name of the object type of the currently selected object connection is presented 
to the right of the radio button text Object Connection. 


Suppress error actions 


Click on the Suppress error actions radio button to turn the suppression flag on and off. 
Suppress is only valid for input connections. For more information, see Section 3.6.7.2, 
Single Connection Window, Single Connection Window. 


Trigger 


Click on the Trigger radio button to turn the trigger flag on and off. When Trigger, which 
is only valid for input connections, is activated, the object currently selected is started 
when the connected object generates the specified event; that is, Trigger specifies an event 
driven execution of the object. See Section 4.3.4.2, Events for more information on the 
events that can be triggered upon. 


Event name 


The event name is displayed next to the Trigger button only if the trigger is set to on. 
Clicking on the event name (EVENT in the example above) produces the Events dialog 
box featuring a list of all available events: 


= Events 


EVENT_HI_LIM 
EVENT_LO LIM 


EVENT_ANY_LIM 


Cancel Help 


Figure 3-19. Trigger Events Dialog Box 


1. Existing object in the system where the IMS node resides. Can be an AdvaInform object as well as a Process Station 


object. 


3BSE 001 013R0501 


3-21 


Advalnform® Object Handling User’s Guide 
Chapter 3 Configuration/Application Building 


3.6.8 File Menu 


3.6.8.1 File - New 
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Click on any event in the list you wish to select or press <ENTER>. Click on Cancel to 
close the dialog box without making a new selection. Click on Help to view Help 
information about this dialog box in a Help message box. 


° OK and Cancel 


Click on OK to confirm and save the information entered on the screen. When you save 
the object, the information is made part of the object configuration. 


Click on Cancel to delete all the information you have entered since the last OK. Cancel 
retrieves the Object connection existing when the object was retrieved or when the latest 
OK was implemented. This works like a Revert function. 


° Help 


Click on Help to view Help information about this dialog box in a Help message box. 


Open... 


Save 


Copy 


eXecute 


Delete 


Exit 


Figure 3-20. File Menu 


You can access New, Open, Save, Copy, Execute, Delete and Exit functions from the File 
menu. Each option is described in detail in the following sections. 


Choose New from the File menu when you want to create an object of a selected object type. 
When the previously selected object is successfully saved, enter the name of the new object in 
the New Name dialog box. 
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= New Name 


New object name 


OK Cancel Help 


Figure 3-21. New Name Dialog Box 


Fields, Push Buttons and Push Keys 


New object name 


Enter the new object name in the New object name field. Click on OK. The object name 
must follow the rules described in Appendix A, Object Name Syntax and Time 
Abbreviations. 


OK 


Click on the OK button after you have finished entering the object name in the New object 
name field. 


Cancel 
Click on the Cancel button to finish the dialog box without creating a new object. 


Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 


<ENTER> 


Press <ENTER> to perform the default action. 


After you enter the object name and it is accepted as legal (it must be unique within the node), 
the new object is created. All attributes are given default values for the object type. The first 
available Normal Operation is selected. Cyclic execution is made inactive. The new object is 
displayed by default, and the first attribute in the attribute list is selected and displayed. 


3.6.8.2 File - Open 


Choose Open from the File menu when you want to select an object type and an object within 
that object type. A pop-up dialog box featuring an object type and object instance selection box 
is displayed. 


Click on the new object type you wish to select in the left-hand selection box. A list of the 
existing objects of that object type appear in a list in the right-hand selection box. 
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NOTE 


The configuration tool works locally in the node where it executes, so you can 
only use it to display and configure objects and object types residing in that node. 
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The objects specified in the connections, however, may reside anywhere in the 
entire system. 


— Object Types Objects 
Al average 1 A 
AO average2 
DI average3 
DO average4 
DAT average5 
[average average6 
unTimeMeas average7 
Text average8 
average9 
average 10 
average tl 
average12 
average13 
average14 
average15 
average16 
ul M 
Selection 
average10 
OK Apply Cancel Help 


Figure 3-22. Object Type/Object Selection Dialog Box 


Fields, Push Buttons and Push Keys 


Selection 


Enter the object instance name in the Selection field or click on the selected object instance 
in the Object Names list to move the object name into the Selection field. Click on OK. 
Object names are not case-sensitive, but must follow the rules outlined in Section A.1, 
Object Name Syntax. 


OK 


Click on the OK button to select the object in the Selection field before closing the 
selection box. 


Cancel 
Click on the Cancel button to close the selection box. 
Apply 


Click on the Apply button to select the object in the Selection field while keeping the 
selection box open. 


Help 


Click on the Help button to view Help information about this dialog in a Help message 
box. 
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° <ENTER> 
Press <ENTER> to perform the default action. 
In summary, you can select objects the following three ways: 


° Double click on the object name you wish to select. The object is selected and the object 
selection box remains open. 


° Single click on the object in the Object Names list or enter the name in the Selection field. 
Click on the OK button. This selects a new object and closes the object selection box. 


° Single click on the object in the Object Names list or enter the name in the Selection field. 
Click on the APPLY button. The object is selected and the object selection box remains 
open. 


NOTE 


By double-clicking in the objects list, you can easily review the objects of an 
object type and study their configuration. To select an object type, single click in 
the Object Types list. 


3.6.8.3 File - Save 


Choose Save from the File menu to save the object currently selected. 


If the object is not authorized for write access, Save is shaded in the File menu and cannot be 
chosen. See Section 3.5.2, Authorization, for further information. 


NOTE 
An error message is presented if all compulsory attributes and connections are not 
properly configured when you attempt to save. If these attributes and connections 
are not correctly configured, the object is not saved. 


3.6.8.4 File - Copy 


Choose Copy from the File menu when you want to copy an object into a new object of the 
same object type. If the current object has been modified since last saved, the object is saved 
with these modifications before copying is completed. 


Enter the name of the new object in the New Object Name field in the Copy Name dialog box 
(see Table 3-23). 


=| Copy Name 


New object name 


OK Cance Help 


Figure 3-23. Copy Name Dialog Box 
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3.6.8.5 File - Execute 


3-26 


Fields, Push Buttons and Push Keys 


New object name: 


Enter the new object name in the New object name field. Click on OK. The object name 
must follow the rules described in Section A.1, Object Name Syntax. 


OK 


Click on the OK button after you have finished entering the object name in the New object 
name field. 


Cancel 
Click on the Cancel button to finish the dialog box without creating a new object. 


Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 


<ENTER> 
Press <ENTER> to perform the default action. 


When the object name is accepted as legal (it must be unique within the node), the Copy action 
is performed and the new object is displayed. It is recommended that you modify the object 
description before saving it. The new object is copied in the same state as the original object. 


NOTE 


You must save the object with File-Save before you can start it. 


Choose Execute from the File menu when you want to start the configuration of cyclic 
execution (if required). This configuration is done in the Execution Configuration dialog box. 
See Section 3.6.10, Dialog for Configuration of Cyclic Execution for more information. 


When you are working in the Execution Configuration dialog box, the Object Configuration 
tool is locked. 
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3.6.8.6 File - Delete 


Choose Delete from the File menu when you want to remove all information about an object. 
The Confirm delete dialog box is displayed with a prompt asking you if you are sure you want 
to delete. 


=| Confirm delete 


Delete of object can not 
be undone! Do you want 


to continue? 


YES NO 


Figure 3-24. Confirm Delete Dialog Box 


Fields, Push Buttons and Push Keys 
° Yes 

Click on the Yes button to confirm your wish to delete. 
° No 


Click on the No button to cancel the deletion. 


3.6.8.7 File - Exit 


Choose Exit from the File menu when you want to terminate the configuration tool. 


3.6.9 Help Menu 


° | 
Help 


On Help 


On Window 


On Keys 


Index 


On Version 


Figure 3-25. Help Menu 
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You can request Help by either: 


Selecting the Help menu, or 


Clicking on Help buttons in the display dialog boxes. 


Help information is displayed in a Help message box. The following options are available from 
the Help menu: 


On Help 


Select On Help if you want information about how to use Help. 
On Window 


Select On Window if you want information about the Object Configuration tool main 
window. The File and Help menus and the OSF/Motif features related to a graphical 
display are described. 


On Keys 


Select On Keys when you want information about how to use function keys, mnemonics 
and keyboard accelerators. 


Index 


Select Index when you want to view an index of all the Help information in the tool. 


On Version 


Select On Version when you want to know the name and the version of the tool. 


3.6.10 Dialog for Configuration of Cyclic Execution 
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Select Execute from the File menu to start the dialog box for the cyclic execution of objects. 
The Object Configuration tool is locked as long as this dialog box is active. You can specify 
execution in almost any combination of cyclic intervals. 
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3.6.10.1 Layout - Execution Configuration Dialog 


3BSE 001 013R0501 


Use the configuration display to set up a time schedule for execution of an instance. Start it from 
the Object Configuration by selecting Execute from the File menu. 


The Object Configuration is locked when the Execution Configuration display is in use to 
prevent other users to configure the User Object. 


The display lets you specify either cyclic execution (defined in seconds) or execution at specific 
times, for example, 12 o’clock the last day of each month, January to October. 


o Execution Configuration 


@ Scheduled Execution Enabled 


Year id 

Month MAR-APR,AUG,NOV Modify 
Day MON-FRI,1,15,LAST Modify 
Hour 6-7,14,22 Modify 
Minute 15 Modify 
Second 0,30 Modify 

Cyclic Execution Enabled 
Interval 7 seconds 
OK Cancel Help 


Figure 3-26. Execution Configuration Dialog 


Scheduled Execution. 


Set the object’s execution time using the Execution Configuration dialog box. The specified 
time interval may be one or several absolute times and gives you full flexibility. You can specify 
a cyclic scheduling from this display and the execution times are aligned to the scheduled times. 


In this example, the execution takes place during March, April, August and November on 
Mondays through Fridays as well as on the Ist, the 15th and the last day of each month 
specified. Execution takes place eight times during each of these days (at 6:15:00, 6:15:30, 
7:15:00, 7:15:30, 14:15:00, 14:15:30, 22:15:00 and 22:15:30). 


Cyclic Execution. 


The cyclic interval is specified in seconds. This is a fast and convenient way to configure a 
cyclic execution. You can use it when the repetition interval is important, not execution at 
specific times. The execution is aligned to the last execution time and not to a schedule. In the 
example in Figure 3-27, the object is executed every seventh second. 
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3.6.10.2 Execution Configuration Dialog - Selections 


Click on OK or Cancel to terminate the Execution Configuration dialog box. Click on OK if 
you want to save the new definition or on Cancel if you do not want to save the new definition. 


The execution method is selected by pressing one of the toggle buttons “Scheduled Execution 
Enabled’ or ‘Cyclic Execution Enabled’. One or none of them can be selected. A new object 
does not have any execution mode set as default. 


= | Execution Configuration 
Scheduled Execution Enabled 
Year a 
Month MAR-APR,AUG,NOV Modify 
Day MON-FRI, 1,15,LAST Modify 
Hour 6-7,14,22 Modify 
Minute 15 Modify 
Second 0 Modify 
H Cyclic Execution Enabled 
Interval 7 seconds 
OK Cancel Help 


Figure 3-27. Cyclic execution selected 


3.6.10.3 Specifying Cyclic Execution 


3-30 


Cyclic execution is valid if the Cyclic Execution Enabled is set to on. The Interval in seconds 
is entered in the corresponding input field. 
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3.6.10.4 Specifying Scheduled Execution 


The specified execution time(s) is valid only if the Scheduled Execution Enabled field is set to 
on. Click on the Scheduled Execution Enabled button! to turn the execution state on or off. 


Enter all time components either as text strings or in separate pop-up dialog boxes. Use the 
corresponding Modify button (to the right of the field concerned) to start the pop-up dialog 
boxes. 


Year 


Enter the year in the Year field as a text string. The text string’s legal format is YYYY, for 
example, 1993. = meaning every year, is also a valid input. 


Month 
Use the following text format for Month: 
e * 
Means that the execution takes place every month. 


> MMM,MMM 


One or several months are specified in a list. See Section A.2, Abbreviations for Months 
for valid abbreviations. 


Example: JAN,NOV 
*  MMM-MMM 


A sequence of months are specified. 


Example: JAN-APR 


Day 
Use the following text format for weekdays (Monday - Sunday): 
e * 
Use * to specify executing every day. 
« DDD,DDD 


One or several days are specified in a list. See Section A.3, Abbreviations for Weekdays 
for valid abbreviations. 


Example: MON,TUE 
« DDD-DDD 


A sequence of weekdays. 


Example: MON-FRI 


1. Since setting the scheduled/cyclic execution to off does not affect the rest of the execution configuration data, it is 
easy to turn the cyclic execution off temporarily and run the object without time execution. 
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Use the following text format for dates (1-31) of the month: 


e * 
Use * to symbolize execution every day. 
° NN,NN 
One or several days of the month (numbers | - 31) are specified in a list. 
Example: 1,5,30 
° NN-NN 
A sequence of days of the month is specified. 
Example: 1-5 
° Last 


Enter Last for the last day of the month. 


Hour 
Use the following text formats for hours: 
e * 
Use * to symbolize execution every hour. 
° HH,HH 
One or several hours (0 - 23) are specified in a list. 
Example: 7,18,23 
° HH-HH 
A sequence of hours is specified. 


Example: 7-9 


Minute 


Use the following text format for minutes: 


e eo 


Use * to symbolize execution every minute. 


Second 
Use the following text format for seconds: 
e * 
Use * to symbolize execution every second. 
° MM,MM 
One or several minutes (0 - 59) are specified in a list. 
Example: 15,30,45 
° MM-MM 
A sequence of minutes is specified. 


Example: 0-15 
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Month Configuration 


=| Month Configuration 

January July 
February @ August 

@ March September 

@ April October 
May m November 
June December 
All None 

OK Cancel Help 


Figure 3-28. Month Configuration Dialog Box 


Choose the month(s) time component using the Month Configuration dialog box. 


Fields, Push Buttons and Push Keys 
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All 
Click on the All button to select all months. 
None 


Click on the None button to select no month. Clicking on the None button clears all 
months before you make a single selection. 


January - December 


Click on the button to the left of each month you wish to select. You can select any 
combination of months. 


OK 


Click on the OK button to save the Month definition and terminate the Month 
Configuration dialog box. 


Cancel 


Click on the Cancel button to terminate the Month Configuration dialog box without 
modifying the Month definition. 


Help 


Click on the Help button to view Help information about this dialog in a 
Help message box. 
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Day Configuration 


= Day Configuration 


M@ Monday @ Thursday Sunday 
H@ Tuesday @ Friday 
HM Wednesday Saturday 


All None 
m1 6 11 16 21 26 31 
2 7 12 17 22 (1127 MLast 
3 8 13 18 23 28 
4 9 14 19 24 29 
5 10 M15 20 25 30 
All None 
OK Cancel Help 


Figure 3-29. Day Configuration Dialog Box 


Selecting Days of the Week 


Use the following push buttons in the weekday portion of the dialog box: 


All 


Click on the All button to select all weekdays. 


None 


Click on the None button to select no week day is selected. Clicking on None clears all 
weekdays before you make a single selection. 


Monday - Sunday 


Click on the box to the left of the weekdays you wish to select. 


Selecting Days of the Month 


Use the following push buttons in the day of the month portion of the dialog box: 


All 


Click on the All button to select all days. 


None 


Click on the None button to select no day. Clicking on None clears all days before you 
make a single selection. 


1-31 


Click on the box to the left of the number(s) corresponding to the days of the month you 
wish to select. 


Last 


Click on the box to the left of Last to select the last day of the month. 
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Common Push Buttons 


You can use the following push buttons from either section of the dialog box: 


OK 

Click on the OK button to save the definition and terminate the dialog box. 

Cancel 

Click on the Cancel button to terminate the dialog box without modifying the definition. 


Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 


Hour Configuration 


a Hour Configuration 
0 4 8 12 16 20 
1 5 9 13 17 21 
2 6 10 14 018 m22 
3 87 11 15 19 23 
All None 
OK Cancel Help 


Figure 3-30. Hour Configuration Dialog Box 


Fields, Push Buttons and Push Keys 
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All 


Click on the All button to select all hours. 


None 


Click on the None button to select no hour. Clicking on None clears all hours before you 
make a single selection. 


0 - 23 


Click on the box to the left of the number corresponding to the hours you wish to select. 
OK 


Click on the OK button to save the definition and terminate the dialog box. 
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° Cancel 


Click on the Cancel button to terminate the dialog box without modifying the definition. 


° Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 


Minute Configuration 


= Minute Configuration 


10 020 1130 40 0150 
11 21 31 41 51 
12 022 032 42 0152 
13 023 033 43 1153 
14 024 034 44 0154 
25 035 45 155 
16 026 036 46 1156 
17 027 037 47 0157 
18 028 0138 48 58 
19 29 0139 49 59 


OoOnN oun hwoOND AO 
3) 
—s 
o 


Pa 


None 


OK Cancel Help 


Figure 3-31. Minute Configuration Dialog Box 


Fields, Push Buttons and Push Keys 
° All 

Click on the All button to select all minutes. 
° None 


Click on the None button to select no minute. Clicking on None clears all minutes before 
you make a single selection. 


° 0-59 

Click on the box to the left of the number corresponding to the minutes you wish to select. 
°* OK 

Click on the OK button to save the definition and terminate the dialog box. 
: Cancel 


Click on the Cancel button to terminate the dialog box without modifying the definition. 
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Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 


Second Configuration 


= Seconds Configuration 

HO 10 020 30 40 (150 
1 11 21 31 41 51 
2 12 022 0132 42 (152 
3 13 023 033 43 1153 
4 14 024 134 44 154 
5 15 025 0135 45 0155 
6 16 026 1136 46 (156 
7 17 27 37 47 57 
8 18 028 (1138 48 58 
9 19 29 0139 49 59 
All None 
OK Cancel Help 


Figure 3-32. Seconds Configuration Dialog Box 


Fields, Push Buttons and Push Keys 


All 
Click on the All button to select all seconds. 
None 


Click on the None button to select no second. Clicking on None clears all seconds before 
you make a single selection. 


0-59 

Click on the box to the left of the number corresponding to the second you wish to select. 
OK 

Click on the OK button to save the definition and terminate the dialog box. 

Cancel 

Click on the Cancel button to terminate the dialog box without modifying the definition. 
Help 


Click on the Help button to view Help information about this dialog box in a Help 
message box. 
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3.7 FAQ (Frequently Asked Questions) 


-Can I pick up a specific object in the Object Presentation display? 


-If you have not activated your internal object in Object Configuration, it is not possible to 
display it in Object Presentation. 


-Can I call user API functions from user objects? 


-Yes, you can! 
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Chapter 4 Runtime Operation 


4.1 Product Operation 


4.1.1 Presentation in Advalnform Display Displays 


The option AdvaInform Display gives you the ability to build presentation of your User Objects 
and include such into various displays. These displays can then be presented using the IMS 
console, connected X-terminals or connected PC-clients. (Depending on which parts of 
AdvalInform Display you have purchased and utilize.) You can also bring up an X-window on an 
operator station to present the displays. 


As AdvalInform Display also supports presentation of objects placed in Advant Controllers, you 
can build powerful display presentation for all categories of personnel that use AdvaInform 
software or need access to data from Object Handling. 


4.1.2 Operating from an operator station 
Use the following operator station functions to configure User Objects: 
° Functionality to build display elements (Master only) 


Use the functionality provided by the operator station to build display elements and 
dialogs for the User Object Types. 


NOTE 


A variety of such display elements and corresponding dialogs already exist for 
basic objects. 


° Display Builder 


Use the Display Builder to configure process displays that contain the display elements 
that you need to operate objects. User Objects can be freely mixed in the displays with 
objects from the Advant Controller. 


° Process Sectioning 
Use Process Sectioning to sort the event and alarm presentation of User Objects. 
You can use the following operator station functions to operate User Objects: 
° Process displays 
Use process displays to display and operate objects. 
° Object displays and object close-up displays 


Use object and object close-up displays to display and operate the basic objects in the most 
detailed way possible (Master). 


° Event and alarm lists 


Use event and alarm lists to display events and alarms and to acknowledge alarms from 
User Objects. (Master) 
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4.1.3 Using Advalnform functions to operate User Objects 


The AdvaInform Basic Units provides functions that are frequently used to operate User 
Objects: 


° Object Presentation Displays for basic objects, which are available from the 
IMS menu 


° SQL*PLUS 


Select Database Access from the Station menu of the IMS main window to start 
SQL*PLUS. From SQL*PLUS, you have read access to all User Object attributes. All 
user object instance tables are available for read access if you use the database as an 
Advant user. 


° User API programming library 


Using the User API programming library, you can write application programs that can read 
and operate on User Objects. 


Embedded SQL 
There are several options available to support the usage of embedded SQL: 


° SQL*Connect Programming. Using the programming libraries provided in SQL*Connect 
Programming you can read object data in several ways and you can even send operation 
requests to objects. 


° Programmer 2000 -Pro*C. You use the Pro*C pre-compiler to compile your programs that 
use embedded SQL. 


With these options and through the usage of embedded SQL you can build all sorts of database 
applications taking full advantage of the user objects provided by Object Handling. 


4.2 Operating Overview 


4-2 


To operate on User Objects, you can: 


° Use the Object Status Display, which gives information and status about existing User 
Objects. You can activate/deactivate User Objects from this display. 


° Use a connected operator station to present and operate on the User Objects. See Section 
4.1.2, Operating from an operator station, for examples of interactions. 


° Use a connected MOD 300 operator station to present and operate on the MOD 300 
DATA_FCM and VA_STRING_FCM objects. See Section 4.1.2, Operating from an 
operator station, for examples of interactions. 


° Use the AdvaInform User API, which gives you several ways to access User Objects. 


° For the IMS basic objects, which are provided in Object Handling, there is an additional 
presentation facility: You can use the IMS Object Forms included in the Basic Functions. 
With these forms, you can present basic object instance in the system. Basic objects are 
well supported by the operator station. There are ready-made display elements and dialogs 
as well as specific object displays with detailed presentation and interaction functionality 
for AI, AO, DI and DO objects in the Master operator station. The MOD 300 Basic objects 
DATA_FCM and VA_STRING_FCM are well supported by the MOD 300 operator 
station. There are ready-made display elements and dialogs for them but they do not have 
any Forms display. 
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4.3 Operating Instructions 


Refer to the various operator stations’ and Advalnform Display User’s Guides. 


4.3.1 Object Status 


The user interface to present configured User Objects is the Object Status display. It gives 
information about existing UserObjects and their status. Start the Object Status display from the 
IMS menu by selecting AdvaInform - Object Handling. 


i] Advant Station 500 Information Management Station ° 
File Station AdvaBuild Advalnform AdvaTalk Session Settings Help Help 


Object Handling 
Reports 


% Object Configuration 


Object Status 
Object Handlers 


Figure 4-1. Selecting the Object Status function 


The Object Status display will show a maximum of 200 User Objects in the scrolled list. The 
filter function must be used to show specific User Objects. 


4.3.1.1 The Object Status Display 


mies UserObject Status oO 


File Help 
ObjectType ll Filter | SW | 
ObjectName State Status Description ObjectType ObjectHandler 


ACC-3012-1_W Inactive Acc. production in hours BASICHANDLER 
ACC-3012-2_W Active Acc. production in days BASICHANDLER 
CALC-512_AV_W Inactive Average result. CALC-512 BASICHANDLER 
CALC-514_AV_W 


Inactive Average result. CALC-514 BASICHANDLER 
CALC-516_AV_W Inactive Average result. CALC-516 BASICHANDLER 
ENG_12_W Active Engine in section BASICHANDLER 
Active Engine in section BASICHANDLER 

Engine in section 3 BASICHANDLER 

TRC-TMP12_W Inactive Temp. object from BASICHANDLER 
TRC-TMP13_W Inactive Temp. object from BASICHANDLER 
TRC-TMP14_W Inactive Temp. object from BASICHANDLER 


Figure 4-2. The User Object Status Display 
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The UserObjects are presented containing the following fields: 


ObjectType 
Name of the User Object type or ALL. 
Filter 


If more than 200 instances exist, the filter must be used to show specific User Objects. 
The following wild cards can be used: 


— 9% A percent sign can match zero or more characters. 

—  _ An underscore in the pattern can match exactly one character. 
ObjectName 

Name of the User Object. 

State 

State field showing whether or not the User Object is started or stopped. 

— Inactive: The User Object is not active, that is, currently not executing. 


-— Active: The User Object is active, that is, executes according to its time schedule and 
to trigger and command requests. 


Status 
Shows the status of the User Object. The status can be 
- OK: The last execution succeeded without problem. 


— Error: One or several of the configured inputs cannot be read. Check the IMS 
System Messages display for more information. 


Description 

Shows the description of the User Object. 
ObjectType 

Shows the User Objects object type. 
ObjectHandler 

Name of the User Objects object handler. 
Activate 


Click on Activate to start the selected User Objects. This enables the User Object for 
configured execution and triggered execution. The presentation of the activated User 
Object is automatically refreshed shortly after the Activate action. 


Deactivate 


Click on Deactivate to stop the selected User Objects. The presentation of the stopped 
User Object is automatically refreshed shortly after the Deactivate action. 


Select All 


Select all User Objects of the selected object type. 
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° Refresh 


Click on Refresh to update all the information on the screen. A cyclic refresh also takes 
place every third minute. 


The User Objects can be selected in the following ways: 
° Single selection 

The mouse button is used to select only one User Object. 
* Continuous selection 


Click one the first User Object and hold the mouse button pressed while dragging the 
mouse arrow to another User Object. All User Objects between these two will be selected. 


Another way is to click on the first User Object and then hold “SHIFT”. Then click on 
another User Object and all User Objects between these two will become selected. 


° Discontinuous selection 


Click on the User Objects which shall be selected while holding “CTRL” pressed. 


4.3.1.2 The File Menu 


The File menu features two items, the Open and the Exit functions. 


File - Open 


~ ObjectT ype Open 


Object Types 


Al 
AO 
coBasicCale 
coExecutor 
coRTM 

DAT 

DI 
DO 


| Cancel | Help | 


° Object Types 


Select the object type from the scrolled list of all defined types with a single click. 

The selected type then appears in the Object Type field of the User Object Status display, 
and the list of User Objects includes the UserObjects of that type. Click on ALL to include 
all User Objects independent of type. 
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: OK 


Click OK when you have selected the desired type. All User Objects of the selected type 
are then displayed in the User Objects Status list. 


$ Cancel 

Click on Cancel to exit the ObjectType Open dialog box without any actions. 
° Help 

Click on Help to view Help information about this dialog box in a Help message box. 
° <ENTER> 


Press <ENTER> to perform the default action. The default action depends on the selection 
made the last time the question was answered. This is marked with a double frame. In the 
figure above, OK is the default action. 


File - Exit 


Exit closes the User Object Status display window and returns to the previously opened 
window. 


4.3.1.3 The Help Menu 


Help 


On Windows 
On Keys 
Index 

On Help 

On Version 


Figure 4-4. Help Menu 


° Help - On Window 

Gives you information concerning the current window. 
° Help - On Keys 

Gives you information about how to use the various keys on the keyboard. 
° Help - Index 


Description of topics related to the User Object Status display. By double-clicking on a 
presented index, you can view the help for that specific part. 


° Help - On Help 
Gives you information about how to use Help. 
° Help - On Version 


Gives you information about the version/revision of the current Object Handling package. 
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4.3.2 Object Presentation Displays 


Refer to the Advalnform Basic Functions User’s Guide and the description of the IMS menu for 
more information on object presentation displays. 


4.3.3  Advalnform Basic Unit Tools 


4.3.3.1 Access through SQL*Plus and Embedded SQL 


The AdvaInform Basic Functions provides both SQL*PLUS and Embedded SQL. Since 
SQL*PLUS and Embedded SQL access are basically the same, only the SQL*PLUS method is 
described in this section. 


Choose Database Access from the IMS menu to start SQL*PLUS. From SQL*PLUS, you have 
read access to all User Object attributes. Some useful operations you can perform on objects 
include: 


° Show what attributes exist for an object type. 
° Present (read) a few attributes for an object instance. 


° Present (read) an attribute for a number of objects that fulfill a certain criteria. 


4.3.3.2 Access through the User API library 


By using the User API programming library, you can write application programs that can read 
and operate on User Objects. Refer to the Advalnform User API User’s Guide for examples. 
Also refer to the Advalnform Object Types Reference Manual for information on how to 
program toward basic objects. 


4.3.3.3 Show an Object Type’s Existing Attributes 


User Object instance attributes are normally available in Oracle tables. For each object type, 
the object type name is the basis for the Oracle table name according to the following name 
convention: CO_object_type_name_INST. It is however possible to turn the disk shadowing 
off. In that case, the attributes are only updated and relevant in primary memory. If you have 
turned the disk shadowing off you can add your user object type to AdvaInform SQL*Connect. 
This makes your instances available through a table name identical to the user object types 
name. The information is read directly from the object when you request for the information. 
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As an example on SQL*Plus access to attributes, the instance table of the object type average 
is shown: 


SQL> describe userobjects.co_average_inst; 


Name Null? Type 
INST_ID NOT NULL NUMBER (6) 
NAME NOT NULL CHAR (20) 
DESCRIPTION CHAR (28) 
STATUS NUMBER 
LOLIM NUMBER (8, 3) 
HILIM NUMBER (8, 3) 
VALUE NUMBER (8, 3) 
LIMTR NUMBER (5) 


4.3.3.4 Present Attributes/One or More Object Instances 


To present (read) the values of a number of instances, you can use either SQL*PLUS or 
SQL*Reportwriter to make selections. For example, read all average objects with a value that 
is outside the LO_LIM2 and HI_LIM2 alarm limits using SQL*PLUS: 


SQL> select name, value, lolim, hilimfromuserobjects.co_average_inst where 
value not between hilim and lolim; 


NAME VALUE LOLIM HILIM 
G3InletMeanTemp 98.1 9:94 4: 1.0:2-310 
B2Room1lMeanTemp 15:51 16.0 24.0 
B2Room2meanTemp 15:23 16.0 24.0 
B2Room3meanTemp 15.0 16.0 24.0 


4 rows selected. 


4.3.4 User Objects in General 


This section describes how the execution of User Objects works and the functionality/meaning 
of various configuration parameters. The description is applicable to all User Objects. 
Since basic objects are ready-made User Objects, it is applicable to them as well. 


Most User Objects have an attribute called STATUS which has at least three status bits, 
active, updated and error: 


° active is set when the object is active/started 
° updated is set as soon as the object has executed once after activation/system start-up 
° error is set as soon as a fatal error in the object’s execution takes place. 


User Objects are not required to have this STATUS attribute. Those User Objects that do not 
have the STATUS attribute are always started as soon as Object Handling is started. 
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4.3.4.1 Execution 


User Objects are executed by a run time environment called Object Handler. Each Object 
Handler is a separate process and manages the instances of one or many object types. 


To configure an object instance, the object must be inactive (stopped). The configuration results 
are stored in the IMS database. The object’s configurable attributes are updated in the object 
instance table. 


When you have finished configuration, you start the object from the configuration tool. 

As a result of your start request, the Object Handler starts the object. It reads all configuration 
information from the IMS database and creates a primary memory copy of the attributes. 

This copy will always be identical to the corresponding IMS database table row. 


When a User Object is executed, the following happens for objects which do not have 
exclusively triggered object connections: 


1. If the object has input connections, subscriptions to the connected objects will be sent and 
the object will be dormant waiting for the data to arrive. An object without input 
connections will of course just ignore this phase. 


The data will be waited for during a certain time.If all data does not arrive within that time 
or if the reading from a connection fails, the following error handling takes place. 


If the flag Suppress error actions is set, the execution will continue with step 2. 
The connection(s) that were not successful are marked with an error. 


If the Suppress error action flag is not set, the execution will be terminated and an 
error message will be sent to the error log. If the attribute STATUS exists for the 
object type, the instance will get its STATUS bit error set. The next execution of the 
object will take place even if one execution has failed. If that one also fails, the only 
difference is that no error message will be sent to the error log. 


2. When all data has arrived successfully, the object starts to execute. Depending on how the 
object was started, different sections will be executed. In all cases, except when a 
command to another Object Operation is received, the Normal Operation is executed. 


During execution of any operation, commands can be sent to output object connections. 
These commands can be sent in 3 different ways. 


a. They can be sent asynchronously, that is, the sending object does not wait for the 
result. As soon as the command is accepted by the core system, the object continues 
its own execution. 


b. They can be sent buffered and asynchronously, that is, the command execution is 
buffered and delayed until the execution of the operation is finished. Then all the 
buffered commands will be sent at one time, a method that reduces the overhead and 
system load from the command sending. 


c. They can be sent synchronously, that is, the sending object waits for a reply from the 
receiving object before continuing. This method is recommended for synchronization 
of actions and when return parameters are vital. The performance is much lower than 
for asynchronous sending though. 
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NOTE 


The way output connections send their commands are selected in the operation 
code. See AdvaBuild Object Type Builder User’s Guide 


If, during execution of an operation, Normal or Command, a run time error such as divide 
by zero occurs, the object instance stops, an error log is sent, and the objects STATUS error 


flag will be set (if existent). 


When the objects operation execution is finished and the disk shadowing is active, any 
attributes modified during the execution are written to the objects data row in the IMS 
database. If no modifications occur, no writing takes place. Buffered asynchronous 


commands, if any, are sent. 


Figure 4-5 shows the object execution over time for asynchronous commands: 


Step 1 


Dormant 


Step 2 


Data requests Data received Execute 


operation(s) 


Commands 


Step 3 


Save 
modified 
attributes 

in the 

IMS database 


Figure 4-5. Time diagram for User Object execution, asynchronous commands 


Figure 4-5 shows the object execution over time for buffered asynchronous commands: 
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IMS database 


Figure 4-6. Time diagram for User Object execution, buffered asynchronous commands 
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Figure 4-5 shows the object execution over time for buffered asynchronous commands: 


Step 1 Step 2 Step 3 
Data requests Data received Execute Save 
operation(s) modified 
attributes 


in the 
IMS database 


Commands 


Dormant 


JUBULIOC 


Figure 4-7. Time diagram for User Object execution, asynchronous commands 


NOTE 


If you use the User API library routines this execution scheme may be changed. 
This is all dependent on which routines you use and how you use them. Some are 
synchronous so you wait for them to complete, some have another behavior. You 
need to understand the User API library and look on these figures to understand 
the whole picture. 


For objects with one or several exclusively triggered object connections, activated by such a 
trigger and with no other input or output connections the execution is simplified as described in 
Figure 4-5 and Figure 4-5: 


Step 1 Step 2 
Execute Save 
operation(s) modified 
attributes 
inthe 
IMS database 


Figure 4-8. Time diagram for User Object execution, exclusively triggered connections 
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4.3.4.2 Events 
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Execute 
operation(s) 


Figure 4-9. Time diagram for User Object execution, exclusively triggered connections, no 
shadowing 


A User Object can generate two types of events. The first type is purely related to event and 
alarm handling. The events are sent to the event and alarm system and have no meaning in the 
interaction between two User Objects. 


The second type of event is a functionality that can be used between User Objects (and other 
applications as well) to start and read data from each other, on an event basis. The User Object 
that wants an event-driven start sets up a read-on-event subscription on another object. When 
that object signals the specified event has occurred, the core system transfers the requested data 
and starts the subscriber object. 


Each event that a User Object issues is declared in the Object Type definition. Those events can 
be subscribed upon (see the description of trigger functionality in Object Configuration in 
Section 3.6.7.3, Object Connection) by other objects. 
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4.4 The Basic Objects 


4.4.1 General 
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The Advalnform Object Types Reference Manual contains a complete description of all basic 
objects. This section gives a brief introduction on how to operate them. 


Object Handling Basic Objects are pre-defined object types for storage of information 
management data. They can be logged by History and can be used in AdvaInform applications. 
They include: 


DATA_FCM Container for up to 20 floating point values (MOD 300) 
VA_STRING_FCM _ String objects (MOD 300) 

DI, DO Boolean objects (On/Off) 

AI, AO Floating point objects 

TXT String objects 

DAT Boolean, Integer, or Floating point objects. 

coExecutor Object that executes any program or script in the IMS 

coRTM Run Time Measurement 

coBasicCalc Object that performs a number of different calculations on 2 to 10 input 


values. Examples on calculations: sum, average. 


The first 8 basic objects are described in terms identical to corresponding object types in Advant 
Controller 400 series. This makes it possible for you to interact with and present them using the 
same facilities as those used for the corresponding objects of that type executed in an Advant 

Controller. Alarm and Event handling (Master only) including presentation in Alarm and Event 
Lists and Alarm Acknowledge are identical to the Advant Controller objects of the same types. 


To operate the coBasicCalc objects you can use the display elements, dialogs (including alarm 
acknowledge) and object displays for AI as coBasicCalc inherits the AI object type. There is no 
display element or object display for the coRTM objects but event and alarm handling including 
alarm acknowledge is available. 


4-13 


Advalnform® Object Handling User’s Guide 
Chapter 4 Runtime Operation 


4.4.2 coExecutor - Execute any Program or Script 


Objects for encapsulation and execution of applications. The coExecutor object gives you the 
ability to, in a controlled way, execute almost any own or third party application software in 
IMS. You can create coExecutor instances to execute the applications according to a time 
schedule, with cyclic intervals or triggered from a process object. As coExecutor instances are 
ordinary objects, you can let any other object send a request for it to execute (the referenced 
application). 


Examples on how to use it: 
° Start a third party optimization software when a certain valve in the process opens. 
° Execute a third party report tool at scheduled times and with certain input parameters 


° Execute a User API application program on a command from an operator. The operator 
changes the state of a connected DI signal which in it’s turn starts the coExecutor object. 


4.4.3 coRTM - Run Time Measurement 


coRTM objects provides you with a basic run time measurement functionality. You will get 
information about how long time pumps, motors and other devices have been running and how 
many times they are started and stopped. You can use this information to build reports using 
AdvalInform Reports or include the information in queries from an Excel spread-sheet in a 
connected PC. 


Two time intervals can be configured. Each time an interval is exceeded an alarm will be 
presented on the operator stations. Thus, the need for maintenance, control or other action that is 
required when the device has run for the specified time, is presented. 


If you configure your run time measurement objects towards a specific process section you can 
use the optional AdvaInform Event Log presentation display to select all run time measurement 
events and print them out. 


4.4.4 coBasicCalc - Basic Calculation Object 
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Without any knowledge about programming you can make simple calculations on Advant OCS 
objects using coBasicCalc objects. The most commonly used arithmetical operations can be 
performed on a number (up to 10) of object values and the result is stored in the objects own 
value attribute. 


As the coBasicCalc object type inherits the AI object type you can present the coBasicCalc 
objects as ordinary AI objects on the operator station or in AdvaInform Display displays. The 
calculation result (AI VALUE and STATUS) can also be logged into Historical logs. If the result 
exceed the configured alarm limits, the result will be events/alarms in the operator station just as 
if the object was an AI. Your operators can acknowledge the alarms just as they acknowledge 
alarms from the process. 


Examples on the performed calculations are sum and average. 
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Chapter 5 Maintenance 


5.1 Preventive Maintenance 


Object Handling requires no scheduled or occasional maintenance actions. 


5.2 Error Messages 


5.2.1 Object Configuration 


Object Configuration presents all detected errors with error messages, as shown in Figure 5-1. 


) Object already exists! 


OK 


Figure 5-1. Example of an Error Message Dialog Box 


You must acknowledge error messages before continuing. Error messages are self-explanatory. 
There are however, some errors that are not that easy to explain in a message box. The message 
“Fatal DB Error: An access to the Db failed. Please note the situation!” is sometimes 
complemented with system messages. Thus, if you cannot find out the reason for the message, 
check the system messages display for such messages. 


5.2.2 Run Time Environment 
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Run time environment errors are reported as system messages. The process name in the system 
message is always the name of the object that sent the system message. You study the system 
messages from the System Messages display which is available from the Station menu of the 
IMS menu. The errors are sorted in two categories: Fatal and Error. The Fatal system messages 
result in a termination of the object. The object is stopped and its error status flag is set to true. 
A listing of system messages, along with an explanation of each system message and a 
recommended course of action, follows. The system messages are documented as follows: 


System Message Text with parameters embedded in ‘’. 
Parameters: Explanation of the parameters. If no parameters exist this section is left out. 


Audience: The audience of the message. Valid entries are Operator, Engineer, 
Service and Debug. Only presented if Audience is other than 
Operator or Engineer. 


Cause: Cause of the error. 


Action: Action to take. 
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5.2.2.1 Fatal System Messages 


5-2 


Configuration Error: Symbol Resolve Error & Object Name 


Cause: 


Action: 


The connected object does not exist any more. 


Reconfigure the connection to a valid object. 


Error: String size error 


Cause: 


Action: 


Programming error in an object operation. A string is too large for its 
definition. The object is allowed to continue the execution, the string is 
truncated to fit in. 


Contact the object type designer. If it is a basic object, contact ABB. 


Object Error: Acknowledge List failed ‘&object.name 


Parameters: 


Cause: 


Action: 


Object Error: 
Parameters: 
Audience: 
Cause: 


Action: 


P1: Name of object for which the error occurred. 


Failed to send acknowledge message to all subscribing alarm lists. The object 
will still be unacknowledged in the lists that it was not acknowledged from. 


Check using System Status and system message if there is a problem with the 
Event and Alarm Distributor object. If so, use the Advant Station 500 
Information Management Station User’s Guide on how to correct problems 
with the E & A Distributor. 


Instance table error ‘&object.name 

P1: Name of object for which the error occurred. 

Service 

Error when accessing the instance table. This error should not occur. 


Try to start the object once more. If the error still occurs, contact ABB. 


Error: Object Type Not In Type Directory & Type Name 


Cause: 


Action: 


The object type does not exist in the runtime type directory. 


Generate the runtime type directory according to instructions in the Advant 
Station 500 Series IMS User’s Guide. 


Object error: OMF bind error ‘&object.name 


Parameters: 
Cause: 


Action: 


P1: Name of object for which the error occurred. 
Internal core system error, can affect future execution. 


Contact ABB. 
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Object Error: Runtime Error in Operation & Object Name 
Parameters: P1: Name of object for which the error occurred. 


Cause: A run time error in the object execution occurred, for example, divide by zero. 
The object status bits error is set and the object is stopped. 


Action: The object must be reconfigured to run again. It probably needs corrections in 
the object type implementation as well. If it is a basic object, report the error 
to ABB. 


Object Error: Reduce Group Error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal core system error, can affect future execution. 


Action: Contact ABB. 


5.2.2.2 Category Messages 


General System Messages 


Connection Error: Bad Object Reference ‘&connection.name &reference 
Parameters: P1: Name of object for which the error occurred. 

P2: Reference of object for which the error occurred. 
Cause: The connected object does not exist any more. 


Action: Reconfigure the connection to a valid object. 


Error: Cannot find Event Distributor 
Cause. The event distributor is down. 


Action: Check the system messages and consult the Advalnform Basic Functions 
User’s Guide and Advant Station 500 Series IMS User’s Guide to find out how 
to start it again. 


Error: Index out of Range 


Cause: Programming error in an object operation. The object is allowed to 
continue the execution. 


Action: Contact the object type designer. If it is a basic object, contact ABB. 


Error: No more Free Memory 
Cause: No more free memory in the machine, no more room to create new objects. 


Action: Delete a few objects handled by that Object Handler. If Advant Station 500, 
extend the UNIX kernel to accommodate larger programs. 
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Object Error: Already Active Error ‘&object.name 


Parameters: 


Cause: 


Action: 


P1: Name of object for which the error occurred. 


Attempt to start an already started object. Probably two applications that 
collide, one trying to activate an already active object. Perform an 
investigation which applications that access the object in question. 


Try to find out which applications interfere with one another. 


Object Error: Connection Read Error ‘&object.name 


Parameters: 
Cause: 


Action: 


P1: Name of object for which the error occurred. 
The connected object does not exist any more. 


Reconfigure the connection to a valid object. 


Object Error: Cyclic Normal Operation error ‘&object.name 


Parameters: 
Cause: 


Action: 


P1: Name of object for which the error occurred. 
The cyclic operation resulted in a fatal error. 


Check for additional system messages for more information on the fault. 
Reconfigure the object if that corrects the error. There may be errors in the 
object implementation as well. 


Object Error: Cyclic Overflow Error ‘&object.name 


Parameters: 


Cause: 


Action: 


P1: Name of object for which the error occurred. 


Cyclic normal operation overflow error. This means that the previous 
execution is not completed when a new request for cyclic execution is issued. 


Reconfigure the execution schedule. Raising the Object Handler priority (use 
the Object Type Builder) or lowering the priority of other programs may also 
solve the problem. 


Object Error: Illegal Normal Operation Reference ‘&object.name 


Parameters: 


Cause: 


Action: 


P1: Name of object for which the error occurred. 


The object does not have a valid Normal Operation configured. It is 
deactivated. 


Reconfigure the object. Report the error to ABB because this should not occur. 


Object Error: No network Address ‘&object.name 


Parameters: 
Cause: 


Action: 


P1: Name of object for which the error occurred. 
No network address can be obtained. 


Check with the main menu System->Communication set up. If not set. Define 
it. Restart the Object handler If other problem. Contact ABB. 
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Object Error: Trigged Normal Operation error ‘&object.name 


Parameters: P1: Name of object for which the error occurred. 


Cause: A triggered (event-driven) execution of the Normal Operation resulted in a 
fatal error. 
Action: Check for additional system messages for more information on the fault. 


Reconfigure the object if that corrects the error. There may be errors in the 
object implementation as well. 


Table Space is full 
Cause: No more free disk memory in the User Object Oracle disk file 


Action: Contact your system manager. The available table space needs to be extended 
by using the Oracle DBA command Alter Tablespace. It is recommended to add 
a file of 1 MB to the table space IMS_USEROBJECTS. The disk file shall be 
placed under: 
/home/opt/advant/UserObjects/standard/oracle/ 


Previous Output Connection not finished & Object Name 
Parameters: PI Name of object for which the error occurred. 
Cause: No response has been received from the previously sent connections(s). 


Action: Configure the object so it execute less frequent. 
Internal Software System Messages 


Error: Bad State 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the Object Handler. Report the error to ABB. 


Lower Level Error: & Object Name 
Parameters: P1: Name of connection/attribute for which the error occurred. 


Cause: This system message is logged together with another log that describes the 
error more thoroughly. 


Action: Look for another system message issued at the same time and take appropriate 
actions according to that. 
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Operation Ignored due to Unresolved Symbols 
Parameters: PI Name of the object for which the error occurred. 


Cause: Some of the connected objects has not been resolved. Therefore the execution 
is not performed. 


Action: Check that the connected object not has been deleted. 


Input Connection Timeout (Subscribe/Refresh) 


Cause: The read request of the connected objects has passed the allowed time. The 
problem is probably caused by high load on the communication network. 


Action: Check that the same result occurs when reading the connected object via 
a User API program. If not, Report the error to ABB. 


Object Error: OMF unbind Error ‘&object.name and deactivate the object 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the Object Handler. Report the error to ABB. 


Object error: OMF View Creation Error ‘&object.name 
Parameters: P1: Name of object for which the error occurred. 
Cause: Internal software error which should not occur. The object is stopped. 


Action: Restart the Object Handler. Report the error to ABB. 


Property error: Lost Reference’ &property.name 

Parameters: P1: Name of connection/attribute for which the error occurred. 

Audience: Service 

Cause: Internal software error which should not occur. The object is stopped. 
The message is combined with another system message. 


Action: Restart the Object Handler. Report the error to ABB. 


String error: String Memory Error & String 
Cause: Programming error in an object operation. A string operation failed. 


Action: Contact the object type designer. If it is a basic object, contact ABB. 
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5.3 Fault-Finding and User Repair 


5.3.1 Object Configuration 


The first thing you should do when any fault occurs is to review the information in this manual 
and the configuration Help function to see if you have made any errors yourself. If you cannot 
find the cause of the problem, there are two possibilities: 


° The Object Configuration tool has a software error, or 
° There is a problem in the run time environment. 


Before concluding that there is an error in the Object Configuration tool, check the run time 
environment according to the instructions given in the following section. 


5.3.2 Run Time Environment 


If you encounter any of the following problems, open the system messages display which is 
started from the IMS menu: 


° your application is not working properly 
° you suspect there is an error when you are working with the Object Configuration tool 
° there seem to be problems with basic object instances 


The system message display makes it possible for you to search for messages within a certain 
time scope. You can also save a complete information about each system message on disk. 


As a second step start the System Status display from the IMS menu. Select the Node Status 
display in System Status and display it for your own node. See the documentation for each 
object type to determine the name of the Object Handler. If System Status indicates that the 
Object Handler is no longer active, use the system message for explanations. Write down the 
system messages to be able to file an error report. The name of the basic object handlers are 
basichandler, basichandler2 and modbasichandler. 


See the errors described in Section 5.2.2, Run Time Environment, for explanations of, and 
actions to correct, errors that have occurred. If you need to restart an Object Handler, refer to 
Section 2.4, Start-Up Procedures. 


If the fault can be identified as a software error, the error shall be reported to ABB. 


5.4 FAQ for IMS Nodes on Plant Network (Master) 


-Why are the objects in some of the controllers not visible/accessible from Object Handling? 


Have you defined the corresponding Controller nodes using the Node broker configuration? If 
not, the nodes are unknown to the core system and therefore the Object handling can not access 
them. 
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Appendix A Object Name Syntax and Time Abbreviations 


A.1 Object Name Syntax 


An object name may consist of up to 20 characters. All characters in the eight-bit ASCII 
international character set (ISO Latin 1) are allowed, except for the following reserved 
characters: 


! 


? 


*and % 
All these characters are reserved for use by ABB. 


Characters according to Table A-1 are supported in object names. 


Table A-1. Legal Characters in Object Names 


Hexadecimal Values Characters 
2D - (minus) 
30-39 0-9 
41-5A A-Z 
CO-DF A-B 
5F _ (underscore 
61-7A a-z 
E1-FF a-y 
. (dot) 


A.2 Abbreviations for Months 


The months are abbreviated as follows: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, 
OCT, NOV, DEC. 


A.3 Abbreviations for Weekdays 
The weekdays are abbreviated as follows: MON, TUE, WED, THU, FRI, SAT, SUN, LAST. 
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Appendix B Object Handlers Commands 


B.1 Introduction 


The Object Handlers utility contains a number of basic services that makes it possible to 
manage the run time environment, that is the Object handlers, and to transfer Object Types with 
their run time environment between Advant Stations. 


The services provided are: 

° List all defined object handlers. 
° Start an objecthandler 

° Stop an objecthandler 


° Dump an object type and it’s run time environment for transfer to another node 
° Load an object handler and all it’s definitions into Object Handling. 


° Removes a transferred object handler and all it’s definitions from the IMS node. 


B.2 Starting the ObjectHandlers Utility 


The ObjectHandlers is an interactive tool. You activate it in the Object Builder terminal window 
by giving the command. 


$ ObjectHandlers 
ObjectHandlers x.y-z> <interactive commands> 
As an alternative, give a command directly on the command line: 


$ ObjectHandlers start MyOwnHandler 


B.3 Command Syntax 
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exit: Logs off the data base and exits the utility. 

help: Gives brief information about all commands. 

list: Lists the names of all object handlers and their current state. The state can be: 
STARTED, starting, stopped, stopping 

start <object handler name>: Start the object handler with that name. 


stop <object handler name>: Stop the object handler with that name. 


dump <object handler name>: Dump all information about an object handler and all its 
supported object types into a transfer file for later transfer to another node. 


load <object handler name>: Load all information about an object handler and all its supported 
object types from the specified file for installation into the node. The file is named <object 
handler name>TRANSFER.tar and must reside under the current directory. 


unload <object handler name>: Remove all information about an object handler and all its 
supported object types from the node. 
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B.4 Examples 
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Load is explained in Chapter 3, Configuration/Application Building. 


START 


To start an object handler called averagehandler do as follows. Start by activating the Object 


Builder terminal window. Then perform the following steps: 


$ ObjectHandlers <ENTER> 


ObjectHandlerUtil x.y-z> list 
NAME Configured_State Actual_State 
averagehandler Stopped Stopped 0 


ObjectHandlerUtil x.y-z> start averagehandler 
ObjectHandlerUtil x.y-z> exit 


ProcessID 


As a verification of the result, the state shall become Starting and then STARTED and the 


ProcessId shall become non zero also for the started object handler. 


STOP 


To shut down an object handler called averagehandler do as follows. Start by activating the 


Object Builder terminal window. Then perform the following steps: 


$ ObjectHandlers <ENTER> 


ObjectHandlerUtil x.y-z> list 

NAME Configured_State Actual_State ProcessID 
averagehandler STARTED STARTED 476 
ObjectHandlerUtil x.y-z> stop averagehandler 


ObjectHandlerUtil x.y-z> exit 


As a verification of the result, the state shall become Stopping and then Stopped and the 
ProcessId shall become zero for the stopped object handler. To see those results you have to 


enter the list command e.g as: 


$ ObjectHandlers list <ENTER> 
NAME Configured_State Actual_State 
averagehandler Stopped Stopped 0 


ProcessID 
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C.1 Introduction 


C.1.1 Service Summary 


ObjectUtil provides a number of basic services for the Object Handling database. 
The utility provides services to handle: 


° global data types 

° activation and deactivation of attribute shadowing to disk 

° dump of object instances into text files 

° population of object instances from text dumps 

° removal of an object type compiled into the database through ObjectParser 
° selecting method to read input connections 


° load balancing 


CAUTION 


The ObjectUtil is an off-line utility requiring restart of the affected object handler 
before changes affect the execution. The population of instances shall only be 
done with the object handler stopped. 


C.1.2 Global Data Types 


ObjectUtil provides services to maintain the database. If global data types have been defined but 
are later made obsolete, you can identify these global data types and remove them with 
ObjectUtil. 


C.1.3 Activation and Deactivation of Disk Shadowing 


By default, when a User Object attribute is updated, the corresponding attribute information in 
the database table is also updated. See Section 3.5.3, Documenting Object Instances for more 
information. For some object types, this is not required or perhaps not even desired as it puts an 
additional load on the system. A typical example is when many objects are updated frequently 
using the EC library as described in Appendix D, External Communication Library 


ObjectUtil provides commands to activate or deactivate this disk shadowing for all objects of an 
object type or just for one specific instance at a time. 
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C.1.4 Dump and Load of Object Instances to/from Text Files 


C.1.4.1 Introduction 


You are often required to load the configuration of object instances from text files. For instance, 
when: 


° you move pre-configured object instances from an in-house system into a plant. 


° the customer supplies configuration data for all objects in the system. This text information 
can be reformatted to suit an appropriate text format. 


° you are upgrading from one IMS version to another, the object database information needs 
to be moved into the new system. 


User Object instances can be described in a source code format. The source code can either be 
generated automatically from existing instances, or manually created in a text editor. The proce- 
dure of dumping existing instances into text files and loading them again is described below. An 
example of the source code is provided. 


C.1.4.2 Dump and Load of Object Instances 


You dump all instances of a User Object type using the command dumpIT: 
Dump: 
$ ObjectUtil dumpIT <objectTypeName> <fileName> 
You load instances using the command popIT: 
Load (populate): 


$ ObjectUtil popIT <fileName> 


NOTE 


You can load all object types from one text file if you merge all text files into one. 


C.1.4.3 Validation Checks 


During the loading of source code the following checks are made: 
e the object names are legal 
¢ attribute values are within the specified ranges or sets 


* constant values given to single connections values are within the specified ranges or sets. 


C.1.4.4 Manual Creation of Source File 
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Use an existing source code file instead of creating a new. If you want to create a large number 
of objects, the most convenient method is to dump one object and then use the editor’s cut and 
paste methods to create copies of it. You have to change at least the object name and all connec- 
tions to other objects, but many attribute defaults can be the same. An example is provided in 
Section C.1.4.6 Example of a User Object Source Code Dump. 
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C.1.4.5 Syntax Description 
dump_spec: 
dumpSpecDefinition: 
objectTypesDefinition: 
object_types: 
object_type: 
objectsDefinition: 


objects: 


object: 


execParams: 
execParams_vl: 
terminalsDefinition: 
terminals: 


terminal: 
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dumpSpecDefinition 
START objectTypesDefinition END 
/* Empty */ 

object_types 

object_type 
| object_types object_type 
OBJECT_TYPE NAME 
/* Empty */ 
| 

objects 

object 
| objects object 
OBJECT NAME 

execParams terminalsDefinition 
END_OBJECT 
execParams_vl 
execParams_vl1 ORACLE SHADOW DATA 
START_TIME DATA 
NORMAL_OPERATION DATA 
/* Empty */ 

terminals 

terminal 

terminals terminal 
ATTRIBUTE NAME DATA 
SINGLE_CONN NAME 
CONN_TYPE DATA 
CONSTANT_VALUE DATA 
CONN_OBJECT DATA 
ATTRIBUTE DATA 
SUPPRESS DATA 
OPTIONAL DATA 
OPTIONAL_USED DATA 
END_SINGLE_CONN 
| OBJECT_CONN NAME 
CONN_OBJECT DATA 
SUPPRESS DATA 
OPTIONAL DATA 
OPTIONAL_USED DATA 
TRIGGER DATA 
EVENT_NAME DATA 
END_OBJECT_CONN 
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Table C-1. Description of the different components 


Identifier name 


Explanation 


Values 


ObjectType Object type name. Identifies the object type | An object type name may be up to 
that the object definition that follows 20 characters. It must start with a letter. 
belongs to. See the OTDL description. 

Object Object name. Uniquely identifies the object. | An object name may be up to 20 characters. 
Must be unique in the IMS system. It is See the Appendix A, Object Name Syntax and 
recommended, but not checked, that itis | Time Abbreviations for reserved characters. 
unique in the whole system. 

StartTime A text string that describes the execution of | When you define this text string, consider the 
the object instances. following: 

A “%” character in the beginning of the text 
means that no cyclic or scheduled execution 
shall take place. 

“%*” is default if no pre-defined execution shall 
be defined. 

Use the Object Configuration display to 
configure the requested scheduling and then 
view the resulting text string in the text field or 
dump the resulting instance to a text file. 

NormalOp An object type can have from one up to ten | 1-10 


different implementations of normal 
operations. Configure which one to execute 
with this parameter. 


(Note that the object type must have the 
corresponding normal operation implemented). 


OracleShadow 


If OracleShadow is active, all attribute 
updates are automatically updated in the 
database as soon as any change occurs. 


Active = ‘Y’ 
Not active = ‘N’ 
Default = ‘Y’ 


AttributeName 


Identifies the attribute that the attribute 
value shall be given to. 


An attribute name may be up to 20 characters. It 
must start with a letter. See the OTDL 
description or the Object Configuration display 
for a list of possible attribute names. 


AttributeData 


Attribute value 


Depends on the attribute data type. Values are 
checked towards defined ranges, sets and data 
formats. 


SingleConn 


Identifies the single connection 


A connection name may be up to 20 characters. 
It must start with a letter. See the OTDL 
description or the Object Configuration display 
for a list of possible connection names. 


ConnType 


Single connection type 


“object” = connected to an object 
“constant” = a constant value is configured 
“none” = not configured 
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Table C-1. Description of the different components (Continued) 


Identifier name Explanation Values 

ConstantValue | Constant value Depends on the attribute data type. Values are 
checked towards defined ranges, sets and data 
formats. 

ConnObject Name of connected object. See object above. Must be the name of an 
existing object. (Checked when the object is 
started.) 

Attribute Name of attribute of connected object. See attribute name above. The attribute name 
must exist for that object type. 

Suppress, See chapter 3 of the Object Type Builder _| Active=’Y’ 

Optional, User's Guide for details on these qualifiers. | Not active=’N’ 

OptionalUsed Default=’N’ 

ObjectConn Identifies the object connection A connection name may be up to 20 characters. 
It must start with a letter. See the OTDL 
description or the Object Configuration display 
for a list of possible connection names. 

ConnObject Name of connected object. See object above. Must be the name of an 
existing object. (Checked when the object is 
started.) 

Suppress, See chapter 3 of the Object Type Builder _| Active=’Y’ 

Optional, User's Guide for details on these qualifiers. | \iot active=’N’ 

OptionalUsed Default=’N’ 

EventName Name of event of connected object. If An event name may be up to 20 characters. 

trigger is active, this event willbe requested | The event name must exist for that object type. 
for and activate the object on event. 
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C.1.4.6 Example of a User Object Source Code Dump 


START 
ObjectType 
Object 
StartTime 
NormalOp 
OracleShadow 
Attribute 
Attribute 
Attribute 
ObjectConn 
ConnObject 
Suppress 
Optional 
OptionalUsed 
Trigger 
EventName 
endObjectConn 
SingleConn 
ConnType 
ConstantValue 
ConnObject 
Attribute 
Suppress 
Optional 
OptionalUsed 
endSingleConn 
endObject 
ndObjectTyp 
END 


The following example shows the source code of an instance with three attributes, one single con- 
nection and one object connection. It will execute once every minute. 


usercalcobjconn 

UCALCOBJCONN_1 

“[%60] (*) / (*) / (*) (*) : (*) /PAR=[DEFAULT] ” 
il 

wy” 

DESCRIPTION “Example Object™ 
STATUS 0 

value 0 

Obj1 

SATO LL 21 

“N” 

“nN” 

wy” 

“N” 


wow 


Ob j2 
“object” 
0 
“AIC71_2" 
“VALUE” 
WN” 

YN” 


ww 


C.1.5 Removal of an Object Type Entered with ObjectParser 


When you use the ObjectParser with the qualifier mode=extparse, the Object Type Definition 
will be stored in the Object Type database. To delete it (for example when you want to redefine 
the Object Type) use ObjectUtil and the command rumTT. 
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C.1.6 Selecting Method to Read Input Connections 


The default method to read input connections keeps all references to the input objects between 
each execution of the object. This method is preferred because of its high performance. If you 
run out of memory on the RTA board, you can use another method. This method sets up all 
references, reads the data and then removes the references each time the object executes. 
Therefore it requires less memory. 


The methods can be selected per object type. To select the method you use the ‘ObjectUtil’ tool: 
$ ObjectUtil subscribeTT <objectTypeName> (default) 
$ ObjectUtil submitTT <objectTypeName> 


This method can only be used when the object handler that manages the object types is stopped. 


C.1.7 Load Balancing 


If many User Objects execute simultaneously the amount of data requests from them to the 
controllers may become too large resulting in overload situations and failure to read data 
properly. A load balance function is provided to prevent overloads. You can configure how many 
User Objects that may request for data simultaneously. 


Use ObjectUtil> queueOH <Obj.Handler name> <max> <min> 


where max=3 and min=1 as default. This means that 3 (max) objects are performing a read 
request of their connections simultaneously. When only | (min) of these three objects hasn’t 
received its request, then the object handler treats another 2 objects to become 3 ongoing 
requests again. 


C.2 Starting ObjectUtil 
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The ObjectUtil utility is activated from the main AdvaInform menu by selecting Object 
Handling and then the sub menu Object Handlers. 


= Advant Station 500 Information Management Station | ° | 
File Station AdvaBuild Advalnform AdvaTalk Session Settings Help Help 


Object Handling + op) = 7 
| ject Configuration 
Reports Object_Status 


Object Handlers 


Figure C-1. Selecting the Object Configuration and Object Handler facilities 


The ObjectUtil is a privileged utility. You must start the IMS menu as a system category user for 
access to it. The ObjectHandlers selection opens up a terminal window. ObjectUtil is an 
interactive tool. Just enter ObjectUtil and You will be prompted for additional commands: 


$ ObjectUtil 


ObjectUtil x.y-z> <interactive commands> 
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C.3 Command Syntax 
exit: 
help: 
IsDT [-full]: 


rmDT <global datatype name>: 
oralTallon <objectTypeName>: 
oral Talloff <objectTypeName>: 


oralTon <objectName>: 


oral Toff <objectName>: 

dumpIT <objectTypeName> <fileName>: 
popIT <fileName>: 

IsTT: 


rmTT <object type name>: 


Logs off the data base and exits the program. 
Provides brief information about all commands. 


Lists names of all global data types and indicates 
whether they are used or not. Unused data types 
can be deleted. If -full switch is given, the data 
type definition is also listed. 


Removes the data type with the given name. The 
data type may not be used by any object type. 


Activates disk shadowing for all object instances 
of the described type. 


Deactivates disk shadowing for all object 
instances of the described type. 


Activates disk shadowing for one object instance. 


Deactivates disk shadowing for one object 
instance. 


Dumps all object instances for the object type into 
a text file. 


Loads all object instances for the object type from 
a text file. 


Lists the names of all object type names entered 
in the database. 


Removes an object type. This is done whenever 
an object type which has already been parsed and 
found error-free from the ObjectParser 
mode=extparse shall be parsed again. An error 
free parsing with that mode qualifier means that 
the object type definition is stored in the Object 
Type database. The old object type definition 
must be deleted before the parsed, error-free 
definition can take its place. 


NOTE 


Use this command only when the object types are entered to the Object Type 
Database by the ObjectParser. In all other cases You must delete the Object Type 


using the ObjectBuilder utility. 
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C.4 Examples 


The following is made within the ObjectBuilder terminal window: 


SObjectUtil 


ObjectUtil x.y-z> l1sTT 
BasicObject 

DCSObject 

BlankObject 

Al 

AO 

DI 

DO 


MyObjectType 


Enter the program and log-on the 
Oracle data base. 


List all object types. 


ObjectUtil x.y-z> rmTT myobjecttype Delete the object type 


ObjectUtil x.y-z> lsDT -full 
USED: TdName 


String (21) 


USED: TdDescription 
String (29) 


ObjectUtil x.y-z> exit 


MyObjectType. 


Exit the program. 
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Appendix D External Communication Library 


D.1 General 


D.1.1 Introduction 
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In many Advant OCS deliveries there are PLCs, DCS systems, or other external systems (called 
EC) that cannot be connected to the Advant OCS system via Advant Controllers. Example 
reasons include: 


° The EC communicates through IEE802.3 carriers. No such facility currently exists on our 
Gateway solutions. 


° There are no Advant Controllers at the site. 


° Another vendors information management or Lab computer needs to be connected. They 
are not suitable to connect through an Advant Controller. 


The most important requirement is to access external data from Advant clients (AdvaInform 
History, AdvaInform Reports, Event and Alarm treatment, operator station Displays, User 
Objects, Calculations) and to read and send information to the External Computer. 


The User Object options AdvaBuild Object Type Builder and AdvaInform Object Handling 
provide a solution to these requirements according to Figure D-1. 


Va 


- 


Clients objects OO oO 
- History lg euler o 
- OS Displays D 
-A&E System 


- Other User Objects 
- Calculations etc. 


User Object 
solution 


Read and Write of 
Object Information 


NM 


Figure D-1. Principal solution to External Communication requirement 


wy, 


The EC systems have object types corresponding to ABB’s AI, AO, DI and DO objects. Other 

frequently occurring object types include Counter objects, Status objects, and Laboratory value. 
They are simple object types with only a few attributes. All these object types either exist within 
AdvaInform Object Handling or they can be built using the ObjectBuilder. 
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The principles for the solution are: 


1. 
2. 


Communication with the EC is achieved through software purchased by the EC’s supplier. 


All data points are represented as User Objects in Object Handling, making them fully 
integrated into the ABB Advant world. User Object Types can be implemented by using 
AdvaBuild Object Type Builder. 


Use AdvalInform Object Handling configuration tools to create and configure instances of 
the object types. These instances will correspond to instances in the External Computer. 


The External Communication library is used to update object instances with information 
from the EC source. The EC library provides higher performance than using the User API 
library as you buffer a number of object updates in one request. 


If output to the EC is required, program that support into the User Objects. When an 
operation is sent to the User Object, the operation sends a message to the Application 
handling the EC communication. It can then convert the message to a suitable format and 
forward it to the EC. 


The detailed solution is described in Figure D-2. 


Advant functions, applications 


Clients 
- History | 
- OS Displays 
-A&E System 

- Other User Objects 
- Calculations etc. 


Unpack 
and call 


ObjectHandler 


EC-library E.g: pipe 
Application Program 


IMS Communication software 


IEE802.3 or 
Serial Port 


External on oe on 


Computer LC eK ~~ Data 
O oO points 
Or Ov 0 (objects) 


Figure D-2. Details of the EC solution 
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D.1.2 The EC Library 


The EC library uses a buffer to achieve high performance. A number of commands are stored in 
a buffer and sent in one request to the objects execution environment (the object handler). 


The EC library consists of three routines—bceiInit, bceiExecOperation, and bceiSend. 
The bceiExecOperation is called from all implementations of object type specific commands. 
The relation between the routines is described in the figure below: 


beeilnit p> Initialize buffer 


Your own 3 
Object Type +> bceiExecOperation ————_> Fill the buffer 
specific routines 


bceiSend: p> Send buffer 


Figure D-3. The relation between the routines bceilnit, bceiExecOperation, and bceiSend 


To send a number of commands to objects, handled by one object handler, execute the following 
(in pseudo code): 
bceilInit; 
while not eofDataToSend { 
unpack data into command parameters 
switch objectType 
case objectTypex: 
switch (bceiObjTypeCommandxX (parl1,par2,par3) ) { 
case bciSUCCESS; 
break; 
case bciNOT_FOUND: 
“error treatment, object name not found locally” 
break; 
case bciNO_SPACE: 
Error treatment, buffer full. Either send current 
buffer and then execute the bceiObjTypeCommandx 
again or terminate with error message 
break; 


}; 
break; 


case objectTypeY 


break; 
}; 
}; // end while 
bceiSend (objectHandlerName) ; 


The bceiObjectTypeCommandxX is a routine that you create for the object type command X. 
It unpacks parameters and gives the right information in the call to the bceiExecOperation 
function. A number of existing, ready-made bceiObjecTypeCommand implementations are 
provided as examples. See Section D.2 and the source files under 
/opt/advant/ObjectHandling/examples/. 


If you want to send information to more object handlers, the whole cycle needs to be repeated. 
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D.1.3 Required Software 


To implement applications with the EC library, you can use the C development license included 
in AdvalInform Basic Functions or you can use the C++ compiler provided as part of Object 
Type Builder. If updating Basic Objects is not enough and other object types are required, you 
need to use the AdvaBuild Object Type Builder to build the required Object Types. 


D.2 Programming an Object Type Specific Command 


D.2.1 Basic Objects 


You begin by programming your User Object types with Object Type Builder or by making sure 
that the object types you are going to use are installed in the type directory. Then you can start 
programming the object type specific commands that use the External Communication library. 


Before you program any object type specific command, look at the corresponding commands 
provided for the AdvaInform Basic Objects. The include file beeiCommands.h and the 
implementation file beeiCommands.c are provided as examples. The implementation of the 
command to the AI object is described below. 


D.2.2 The bceiExecAlOrder Routine. 


D.2.2.1 Steps to Perform 


The implementation of a command to an object type can be split into the following steps: 
1. Make the appropriate include file. 
2. Declare the call to the library function 


3. Implement the library function 


D.2.2.2 The Include File 
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Make a define statement according to normal C programming practice. 


#ifndef bceiCommands_h 
#define bceiCommands_h 
#ifdef cplusplus 
extern “C” { 

#endif 
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D.2.2.3 Declare the Call to the Library Function 


Make it a rule to describe the parameters and the functionality of the function. 


D.2.2.4 Implement the Library Function 


BciStatus bceil 


ExecATOrder ( 


const char* objectName, 
float value); 


/* 


PARAMETERS 


objec 


value 
DESCRIPTION 


The bceil 


opProper 


tname = Nam 


of object instance 


= Value to be set for the object 


Manual. 


Kf 


ExecAlOrder is the specialized function for setting 
the value of an AI object. It uses the appropriate opCode and 
ty to do that according to the Object Type reference 


The implementation requires that you include a number of standard C and AdvaInform include 


files: 


#include 
#include 


#incl 
#incl 
#incl 
#incl 
#incl 
#incl 
#incl 
#incl 
#incl 


lude 
lude 
lude 
lude 
lude 
lude 
lude 
lude 
lude 


<stddef. 
<stdlib. 
<string. 
<sys/types.h> 
<time.h> 


<mall 


oc. 


<omfType 
<omf_AI. 
<dccodes.hh> 
<bciUserAPI.h> 
<bceiCommands.h> 


n> 
n> 
n> 


h> 
Directory.h> 


n> 


The implementation of the code uses the C structures and the C constants that are defined in the 
Type Directory when an object type is included there. Se the Object Type Reference manual for 
more information. The information is included as the omf£_ATI .h include file is included. 
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A construct is available for storage of all parameters: 
BciStatus bceil 


{ 
f* BL */ 


ExecATOrder ( 


BciStatus aiResult; 
BciObjStatus aiObjStatus; 
int aiOperation 


const char* objectName, 


float value) 


= { OMF_AIORDERID }; Loree = from omf_AIl. 
size_t aiOperSize = { sizeof( Omf_AIORDER ) };<-from omf_AI. 


Omf_ATORDER aiOperOrder; <------ from omf_AI.h 
aiOperOrder.opCode = dcVALUE_CHANGE_DCX; <--- from dccodes.hh 
aiOperOrder.opProp = dcACT_VALUE_DCX; <--- from dccodes.hh 
aiOperOrder.typeOfReq = dcPROG; <--- from dccodes.hh 
aiOperOrder.eventLog = gcFalse; According to the 
aiOperOrder.dialogId = 0; Object Type Reference 
aiOperOrder.aValue = value; Manual 
aiOperOrder.dValue = 0; 
aiOperOrder.status = 0; 
aiOperOrder.textIndex = 0; 
aiResult = bceiExecOperation( (char*) objectName, 
aiOperation, 
aiOperSize, 


return (aiResult); 


} 


&aiOperOrder) ; 
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D.3 Creating your External Communication Program 


D.3.1 Includes 


You need the following includes in your test program assuming that the object type specific 
commands are declared in the include file bceiCommands.h: 


#include <stddef.h> 

#include <string.h> 

#include <malloc.h> 

#include <omfTypeDirectory.h> 
#include <omfAttributeT.h> 
#include <bciUserAPI.h> 
#include <bceiCommands.h> 


D.3.2 Example: The C Program Updating Basic Objects 
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A description of setting the value of the Basic Object AI follows: 


1. 


Make the appropriate includes as described above and then declare your main program. 
int main( int argc, char* argv[] ) 


As the next step, declare the required local variables and initialize any C++ constructors 
{ 
/* AI */ 
BciStatus aiResult; 
char* aiObjNames [MAX_NO_OF_OBJS]; 
float aiFloat; 


#ifdef __hpux 

/* 

// If HP environment: run constructor for C++ as program coded 
inc 

Ky: 

—main(); 

#endif 


Initialize the buffer: 
bceilInit(); 
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4. Send an AI value. In a real application this is repeated for all the received AI values. 
Error treatment should be done in the level above the library routine, see Section D.1.2 . 
The print-outs are just for documentation purposes and should not exist in a final version: 
PROBL *Y 
aiFloat = 1.234; 
aiResult = bceiExecAIOrder( (char*) aiObjNames[0], aiFloat ); 
if (aiResult != bciSUCCESS) 
printf( “%s: bciExecOperation(%s) ERROR %Sd\n”, 
argv[0], aiObjNames[0], aiResult ); 


else 
printf( “Ss: AI Object named ’%s’ successfully updated\n”, 
argv[0], aiObjNames[0] ); 


5. When all commands are given, execute them all in one request: 
strcpy (objectHandlerName, “basichandler”) ; 
bceiSend( (char*) objectHandlerName) ; 


6. Terminate the program: 
exit( 0 ); 


D.4 Initialize External Interface Buffer 
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This function is designed to initialize the external communication functions. The initialization 
prepares the buffer and initializes for all calls to other EC routines that follow. 


Calling format 


Name: bceilnit 


Synopsis 


BciStatus bceiInit() 


Parameters 


None 


Description 


The external communication functions maintain an internal request buffer where all requests 
submitted through one of the functions are put. The function bceiInit flushes and initializes this 
request buffer so that the next bceiExec. request will be the first operation request in the buffer. 


Return Value 


bceiInit = none (A simple initialization which can’t go wrong) 
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D.5 Execute Operation 


Introduction 


The execute operation stores one command request into the external communication buffer. 


Calling format 


Name: bceiExecOperation 


Synopsis 


BciStatus bceiExecOperation( 
const char*objectName, 
int operationId, 
int argSize, 
void* arguments) 


Parameters 


objectName = Name of object instance for operation request 
operationId = Operation id. 
argSize = Number of bytes of argument data in Argument 
arguments= Pointer to array or structure or other data type 
where all arguments are stored, one after the other, in the order 
the arguments are defined for the operation. 


Description 


The bceiExecOperation function is the generic function used to put one execution request for 
one operation in the EC request buffer. To make sure the buffer is empty, bceiInit must be called 
before the first bceiExecOperation call. Subsequent calls to bceiExecOperation put all requests 
in the same request buffer one after the other. No requests are sent to the object system unless 
bceiSend is called. 


The bceiExecOperation function resolves the given object name. The majority of the possible 
error messages from the call are related to the object name resolving. 


Return Value 
bceiExecOperation= bciSUCCESS if OK 
= beiILLEGAL_NAME if illegal characters are included in the name 
= bciNOT_FOUND if the object does not exist in the IMS node. 
= bciNO_SPACE if the send buffer is full 


= other error codes: See User API documentation. 
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D.6 Send the Buffer 


D-10 


Introduction 


The send function sends the buffered commands to the specified object handler. 


Calling Format 


Name: bceiSend 


Synopsis 


BciStatus bceiSend(const char* objectHandlerName); 


Parameters 


objectHandlerName = Name of object handler to send the command (buffer) to. 


Description 


The bceiSend function sends the EC request buffer to the object system. All requests put in the 
request buffer, since the last bceiInit call, are now sent to the object system. After a successful 
bceiSend call, the request buffer has been sent but is not flushed. The request buffer must be 
flushed through a bceilnit call before new requests are put in the buffer. 


Return Value 


bceiSend=  (bciSUCCESS) if OK 
= _ beiFailure 
If the object handler fails to perform any of the operations. 
Error logs will be created to document the failing objects. Use 
the System Message Display to view the details. 
= beixx 


See the documentation of the User API in the Advalnform 
User API for documentation of other possible return statuses. 


3BSE 001 013R0501 


AdvaInform® Object Handling User’s Guide 
Section D.7 Examples 


D.7 Examples 


D.7.1 The Basic Objects Example 


An example of how to use the EC library is provided in the directory 
/opt/advant/ObjectHandling/examples/: 


° bceiCommands .h and bceiCommands .c for the basic object command 
implementations. The Makefile: beeiMakefile (execute make -f bceiMakefile) lets 
you compile bceiCommands. 


° bceiLibraryExample.c gives an example of an implementation which makes it 
possible to update basic objects. The Makefile bceiMakefile lets you compile and 
link the test program. To execute it, write: 


bceiLibraryExample AlobjectName AOObjectName DIObjectName 
DOObjectName DATObjectName TextObjectName. 


Only the AI object name is compulsory. 


D.7.2 Other Ways to Use the EC Library 


The EC library can also be used for other types of applications where data from the applications 
needs to be available for the user’s of the ABB system, for example: 


By storing results of optimizations in local AdvaInform Basic Objects, the optimization 
results become available for presentation on the operator station and available through 
SQL for e.g. spread-sheet programs in connected PC’s. 


D.7.3 Using C or C++ Compilers 


You can compile Your EC library application with the C or with the C++ compiler. The example 
Makefile bceiMakefile is pre-configured for a C compiler. To change to the C++ compiler 
you change the bceiMakefile variable CC to CC using the editor of your preference. 

The default (C compiler) is c89+te. 


D.8 Linking Your Application 


To link your application, include the bceiLibrary.a as provided under 
/opt/advant/ObjectHandling/1ib. Since additional libraries are required as well, 
copy the Make file bceiMakefile and use it as a base for your development. 
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Appendix E Views towards Configuration Data 


E.1 Introduction 


The configuration data of the UserObject instances are easily accessible via two predefined 


Advalnform® Object Handling User’s Guide 
Section E.1 Introduction 


Oracle Views. The views are accessible from any IMS users database account. 


E.1.1 UO_INSTANCES View 


The INSTANCES view is an overview of all UserObject Instances with information of their 


execution and normal operation configuration. 


Table E-1. The INSTANCES view 


Column Name DataType Description 
OBJECT_TYPE_NAME | VARCHAR(20) - 
INSTANCE_NAME VARCHAR(20) - 
START_TIME LONG Configured execution 
NORMOP NUMBER(3) Configured normal op 


E.1.2 UO_CONNECTIONS View 


The CONNECTIONS view contains the configuration data of the object’s connections. 


Table E-2. The CONNECTIONS view 


Column Name DataType Description 

OBJECT_TYPE_NAME — | VARCHAR(20) - 

INSTANCE_NAME VARCHAR(20) - 

CONNECTION_NAME VARCHAR(20) - 

OPTIONAL_USED VARCHAR(1) Indicates whether the 
connection is used.(Y,N) 

CONNECTED_TO VARCHAR (20) The connected object, or 
constant value. 

ATTRIBUTE VARCHAR (20) The connected attribute 
(Relevant for Single 
Connection) 

TRIGG VARCHAR (1) Triggered connection(Y/N) 
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E.1.3 Example 


SQL> select CONNECTION_NAME,OPTIONAL_USED,CONNECTED_TO,ATTRIBUTE,TRIGG from 


UO_CONNECTIONS where INSTANCE_NAME=’PTTSubscrRemote_8’; 


CONNECTION_NAME 


DAT opt 
DAT2opt 
DAT3opt 
DAT4opt 
DATSopt 
DI lopt 
DI2opt 
DI3opt 
Di4opt 
DISopt 
DOlopt 
DO2opt 
DO3opt 
DO4opt 
DOSopt 
TEXT opt 
TEXT2opt 
TEXT3opt 
TEXT4opt 
TEXTSopt 
sinfloatO 
sinfloatl 
sinfloat2 
sinfloat3 
sinfloat4 
sinfloat5 
sinfloat6 
sinfloat7 
sinfloat8 
sinfloat9 
sinintlol 
sinintlo2 
sinintlo3 
sinintlo4 
sinintloS 
sinintsh1 
sinintsh2 
sinintsh3 
sinintsh4 
sinintsh5 


50 rows selected. 
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CONNECTED_TO ATTRIBUTE E, 


AIC71_11 
AIC71_12 
AIC71_13 
AIC71_14 
AIC71_15 
AOC71_11 
AOC71_12 
AOC71_13 
AOC71_14 
AOC71_15 
DAT71_111 
DAT71_112 
DAT71_113 
DAT71_114 
DAT71_115 
DIC71_11 
DIC71_12 
DIC71_13 
DIC71_14 
DIC71_15 
DOC71_11 
DOC71_12 
DOC71_13 
DOC71_14 
DOC71_15 
TX71_11 
TX71_12 
TX71_13 
TX71_14 
TX71_15 
AIC71_5 
AIC71_6 
AIC71_7 
AIC71_8 
AIC71_9 
AIC71_10 
AIC71_11 
AIC71_12 
AIC71_13 
AIC71_14 
10 
20 
30 


DAT71_11 
DAT71_12 
DAT71_13 
DAT71_14 
DAT71_15 


VALUE 
VALUE 
VALUE 
VALUE 
VALUE 
VALUE 
VALUE 
VALUE 
VALUE 
VALUE 


IW_VAL 
IW_VAL 
IW_VAL 
IW_VAL 
IW_VAL 
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